API & MCP

Launch from your agent. Search what's debuting, audit a site before launch, and draft a listing without leaving your editor. Agents can only create drafts: you review, pick a plan and submit in the browser, and every listing is reviewed before it goes live.

1. Create a token

Reading and readiness checks work without one. Drafting and your stats need a token: connect over OAuth (below), or create one from Dashboard → API & agents.

2. Connect over MCP

Easiest: add https://preview.debutyard.com/mcp as a custom connector (Claude, ChatGPT, Cursor and other clients that support OAuth). Your browser opens, you approve the app, and it gets its own token: no copying needed. Remove it any time from the tokens page.

claude mcp add --transport http debutyard https://preview.debutyard.com/mcp

Or paste a token. Streamable HTTP at https://preview.debutyard.com/api/mcp (works without a token for the public tools).

Claude Code

claude mcp add --transport http debutyard https://preview.debutyard.com/api/mcp \
  --header "Authorization: Bearer dy_your_token"

Any client with a JSON config (Cursor, Windsurf, Claude Desktop via mcp-remote)

{
  "mcpServers": {
    "debutyard": {
      "url": "https://preview.debutyard.com/api/mcp",
      "headers": { "Authorization": "Bearer dy_your_token" }
    }
  }
}

Then ask: “Check if my site is ready to launch on DebutYard and draft the listing.”

Tools

search_products

Search products that have debuted on DebutYard by name, tagline or category.

get_product

Full details for one live product: description, maker, categories, applause, rank and awards.

list_categories

Category slugs to use with search_products and submit_product.

list_launch_directories

Directories and launch boards to submit a product to after launch, with Domain Rating (show the attribution next to it), pricing, link type (marked when verified by our own checks) and whether a badge or the maker personally is needed.

check_launch_readiness

Audit a product URL before launch: HTTPS, title, meta description, social image, indexability, duplicates and the DebutYard badge. Returns a 0-100 score, checks with fixes, a suggested listing and the next weeks with room.

check_dofollow

Load a page (e.g. a directory listing) and check whether it links to a domain, and whether that link is dofollow or nofollow/ugc/sponsored. Returns the verdict, rel, anchor text and a plain-English explanation.

check_dr

A domain's Domain Rating by Ahrefs (0-100, returned as dr). Show the returned attribution next to the score. Cached for 7 days. Needs a connected account or API token; limited per account and per day.

submit_product

Create a DRAFT listing for the user's product (needs an API token). It is not submitted: the user opens the returned link to review it, choose a free or paid debut and submit. Run check_launch_readiness and list_categories first.

get_my_launches

The user's listings with status, debut week, badge status, applause, views and clicks (needs an API token).

get_my_links

The user's backlinks in Link Monitor (from their directory tracker, submission orders and links they added): URL, verdict (dofollow, nofollow, missing, unreachable), rel, anchor and when it was last checked, plus plan usage (needs an API token).

3. Or use the REST API

Base URL https://preview.debutyard.com/api/v1. Responses are { data } or { error }. Full spec: openapi.json.

GET	/products?q=&category=	Search live products
GET	/products/{slug}	One product
GET	/categories	Category slugs
GET	/directories?niche=&noBadge=	Launch directories to submit to
POST	/readiness	Launch-readiness check for { url }
POST	/tools/dofollow	Is there a dofollow link to { target } on { pageUrl }?
POST	/tools/dr	Domain Rating by Ahrefs for { domain } (token)
POST	/submissions	Create a draft listing (token)
GET	/me/products	Your listings and stats (token)
GET	/me/links	Your monitored backlinks and plan usage (token)

curl -X POST https://preview.debutyard.com/api/v1/submissions \
  -H "Authorization: Bearer dy_your_token" -H "Content-Type: application/json" \
  -d '{"websiteUrl":"https://acme.io","name":"Acme","tagline":"Invoices that chase themselves",
       "description":"Acme sends polite, automatic reminders so clients pay on time.",
       "categories":["productivity"],"pricingModel":"freemium"}'

On Windows PowerShell, curl.exe loses the quotes inside the JSON. Use Invoke-RestMethod instead:

$body = @{ websiteUrl = "https://acme.io"; name = "Acme"; tagline = "Invoices that chase themselves"
  description = "Acme sends polite, automatic reminders so clients pay on time."
  categories = @("productivity"); pricingModel = "freemium" } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri https://preview.debutyard.com/api/v1/submissions `
  -Headers @{ Authorization = "Bearer dy_your_token" } -ContentType "application/json" -Body $body

Readiness checks and each free tool are limited to 15 an hour per caller. Questions: support@debutyard.com.