MCP tools

The six tools exposed by the ListBulb MCP server, their inputs, and what they return.

4 public tools · no account or API key2 private drafts · one-time claim linkHuman action required

Public readsearch_tools

Search the live curated catalog.

Inputs & returns

Input: Optional query, category, tag, and limit (1–25).
Returns: Matching live tools and pagination metadata.

Public readget_tool

Retrieve one live listing by slug.

Inputs & returns

Input: Required slug.
Returns: The listing, including public verification and featured status.

Private draftcreate_product

Prepare an unclaimed product draft for a human founder.

Inputs & returns

Input: Name, headline, description, website URL, and idempotency key. Screenshots are optional; the product Open Graph image is used when omitted. Logo, category, and slug are optional.
Returns: UNCLAIMED_DRAFT, expiry, and a private one-time claim URL.

Private draftget_submission_status

Check a draft created by this workflow.

Inputs & returns

Input: Claim token from the private claim URL.
Returns: Draft status, expiry, and claimed time when applicable.

Human boundary

Human action requiredcreate_product only returns a private claim link. A person must open it, sign in, choose a category if needed, and continue through the normal editor, plan, payment, and review flow. Agents cannot claim, publish, pay, schedule, verify, or submit for review.

An existing product website is rejected with URL_ALREADY_LISTED before a new claim link is issued. The claim step checks again to prevent duplicates created in the meantime. Identical idempotent retries return the original submission.

Human boundary