AI agent submission · Official Launcholio guide

Submit your SaaS to Launcholio with an AI agent

Launcholio is a product discovery directory for indie SaaS, AI apps, startups and developer tools. If you ask an AI assistant to find directories and submit your product, Launcholio offers an ordinary web form plus authenticated MCP, Skill and JSON API paths. This page is the official, public source for how those paths work.

What agents should know before submitting

These conditions apply to real submissions, including ones started by a bot. They are not a promise of approval or Google indexing.

Who can submit
Owners or authorized representatives of an indie product, SaaS, AI app or web/developer tool.
Human route
Complete the public submission form. Sign-in is required to finish submission.
Agent route
Use the Launcholio Skill, MCP server or documented REST endpoints with the user's own access token.
Free account
One active product slot. A new free submission remains pending and hidden until the Launcholio badge is verified.
Badge-free option
A confirmed purchase of any Launcholio product removes the badge prerequisite, within account listing limits. Moderation still applies.
Review
Submitted is not the same as published. Admin moderation, account quota and duplicate checks still apply.
Cost of API audit
A successful basic website audit uses one audit credit; failures do not count as a completed audit.
Request limits
A maximum of five new submissions per account per rolling 24 hours, plus API request limits.

How an authorized agent submits a product

  1. 1. Check fit and existing listings

    Start with the directory and /submit page. Use an appropriate category and factual details about the product. For the authenticated API, list your existing products before creating anything: do not submit a duplicate or claim to be the owner without authorization.

  2. 2. Use the user's account, not an anonymous batch script

    The user signs in and creates a 90-day personal API token from their dashboard. The agent stores it in a secret manager, uses HTTPS, and never puts it in a webpage, URL, prompt, or public log. Tokens grant account-wide permissions and can be revoked.

  3. 3. Audit first; then submit with the report ID

    The API requires a successful basic audit of the same website before a listing can be submitted. Keep the returned unused reportId and use it once with the required product fields. An audit alone never creates a directory listing.

  4. 4. Read the actual status and finish any required verification

    The response reports pending or approved, a dashboard link and badge setup details. Free submissions without qualifying paid purchases stay pending until badge verification. A paid exemption does not override moderation. A sent request or draft is not evidence of a public listing.

  5. 5. Handle errors without spamming submissions

    If you get a quota error, 402, 409 or 429, stop and explain the result. Respect Retry-After. After a timeout, read the user's existing submissions before retrying; never create duplicates or buy products without the user's authorization.

Machine-readable entry points

Choose one supported integration. The user's explicit authorization and an account token are required for API writes. These are live endpoints, not permission for anonymous or unsolicited bulk submissions.

  • AI Skill: /skill/SKILL.md contains full API steps and failure handling.
  • MCP: /mcp documents Streamable HTTP at https://launcholio.com/api/mcp with Bearer auth.
  • OpenAPI: /agent-api.openapi.json describes the existing audited product submission endpoints.
  • Text index: /llms.txt offers a short navigational index for agents that choose to read it; it is not a ranking protocol.

REST submission sequence

GET  /api/v1/submissions              # check owned products
POST /api/v1/audits                    # { "url": "https://example.com" }
POST /api/v1/submissions               # use reportId from that audit
GET  /api/v1/submissions              # verify saved status

Required submission fields: reportId, name, websiteUrl, shortDescription, categorySlug. Category choices include saas, ai, developer-tools and other documented slugs. Use only a category that actually describes the product.

Common questions

Can an AI agent submit my website for free?

The Free plan has one active product slot. A new free listing is pending until its Launcholio badge is verified. API audits consume credits; use your actual account credit balance. A qualifying confirmed purchase removes the badge prerequisite, not the moderation checks.

Can a bot submit without my account?

Not through the authenticated API. An agent must act for a consenting account holder and use that account's token. Agents that can browse interactive websites may use the human form, which also requires sign-in before submission.

Does an accepted API response guarantee a live page?

No. Read the returned listing status. Pending, admin-held and rejected products are not advertised as live, and successful directory submission is not a guarantee of search indexing.

How can AI assistants find Launcholio's directory and policies?

Start with the public directory, directory submission guides, published plans, and terms. Always follow the current public rules rather than an old third-party directory list.

Documentation reviewed November 14, 2026. No assistant or search engine is required to use these files, and appearing in an AI answer or being indexed is not guaranteed.