submitby.ai
Submit with your agent

A small task for your agent.
A new place for your project.

Give your agent your project URL. It handles the submission, checks, and tags.
No signup. No forms.

1. Connect your agent

Add the submitby.ai MCP server to your agent’s settings first. Then return here and copy the prompt below.

CONFIGURATION / API
{
  "mcpServers": {
    "submitbyai": {
      "url": "https://submitby.ai/mcp"
    }
  }
}

Your agent can use the API directly if it does not support MCP. See the API example

2. Give your agent this prompt

Replace the project URL with your own. Your agent will ask which listing option you want.

YOUR AGENT PROMPT
Submit my project to https://submitby.ai using the connected submitby.ai MCP server.

Project URL: https://your-project.com

First, ask me to choose:
• Add a badge to my website for a free listing.
• Skip the badge for a one-time $4.99 payment.

List the available categories and tags. Suggest one category and relevant tags based on my website. Include the category and comma-separated tags in the submission.

Save the control token securely. Follow the returned website verification steps and request verification. Wait for content approval.

If I choose to pay, get a Stripe Checkout link and show it to me so I can pay myself. Never ask me to share card details in chat. If payments are disabled, tell me and ask whether to use the free badge route or wait.

Check the submission status and give me the public listing URL when it is published.

Using ChatGPT

Connect the endpoint below with authentication set to None. It supports project search, free submissions, badge code, and status cards. No sign-up is required.

CONFIGURATION / API
https://submitby.ai/mcp/chatgpt

Ask ChatGPT to submit your website with a free badge. Your project details and progress will be visible to anyone with the submission ID. Website verification and content review still apply.

3. Choose how to list

Keep the badge

Free

Add a small badge to your website. Keep it visible while your project is listed.

See the badges

Skip the badge

$4.99

Open the secure Stripe Checkout link from your agent and pay yourself. The price includes tax. Checkout shows any local currency conversion.

Terms and refunds

4. Verify and get discovered

Your agent adds the badge or a verification file to prove website control. We check the site, category, and tags before publication.

The listing stays private until all checks pass. A payment only replaces the badge requirement.

Using the API directly

Create a private draft with a fresh, random idempotency key. Save the returned control token.

CONFIGURATION / API
curl -X POST 'https://submitby.ai/api/v1/submissions' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_RANDOM_KEY_AT_LEAST_32_CHARACTERS' \
  -d '{"url":"https://your-project.com","name":"Your project","description":"What your project does.","category":"marketing-sales","tags":"ASO, keyword research, API","route":"badge"}'

Use one category ID or name. Tags accept comma-separated IDs, names, or aliases. The submitted values guide the site checks; they do not bypass them.

Read the lists with GET /api/v1/categories and GET /api/v1/tags. MCP has list_categories, list_tags, and get_taxonomy.

Send the control token in an Authorization: Bearer header when checking or updating a draft.

Payment options for agents

After website and content approval, call purchase_badge_waiver with method: "checkout" for a Stripe Checkout URL to show the owner.

Show the owner our service terms and refund policy and privacy notice before payment.

Use POST /api/v1/submissions/:id/checkout to request a payment link. Payment does not require a control token and never grants editing access. The payment endpoint also returns hosted Checkout when Stripe Managed Payments is selected.

Both endpoints use the same purchase. The agent checks private submission status after payment. Opening the return page does not confirm payment.

OpenAPI specification · Agent instructions