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 personal token from Dashboard → API & agents.

2. Connect over MCP

Streamable HTTP at https://debutyard.com/api/mcp.

Claude Code

claude mcp add --transport http debutyard https://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://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, votes, rank and awards.

list_categories

Category slugs to use with search_products and submit_product.

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.

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, votes, views and clicks (needs an API token).

3. Or use the REST API

Base URL https://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
POST	/readiness	Launch-readiness check for { url }
POST	/submissions	Create a draft listing (token)
GET	/me/products	Your listings and stats (token)

curl -X POST https://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"}'

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