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.

Submit with ChatGPT · Connect another agent

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.

Fill the optional listing fields from facts on my website, in your own words: tagline, long description, audience, screenshots with alt text, pricing, platforms, official links, and App Store or Google Play URLs. Ask me before you add anything the website does not say.

Save the control token securely. Follow the returned website verification steps and request verification. Automatic checks usually publish the listing within minutes.

Then read get_submission. Answer the returned faq_questions with facts from my website, and follow the completeness suggestions until the listing reaches the indexable score.

Continue with payment only if I choose the paid route. If you have an authorized MPP payment client, request method "mpp" and follow the returned payment instructions. Otherwise get a Stripe Checkout link and show it to me so I can pay myself. Show me the payment terms before payment. 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.

How to submit your project with ChatGPT

Use a ChatGPT account with access to custom MCP apps. Follow OpenAI’s connection guide to add the server below. Choose None for authentication. You do not need a submitby.ai account.

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

This connection supports project search, free submissions, badge code, and status cards. Enable it in your chat before you use the prompt.

  1. Replace the example URL with your public project website.
  2. Copy the prompt into the chat with submitby.ai enabled.
  3. Check the project details before you approve the submission.
  4. Add the exact badge code to visible HTML on your website.
  5. Tell ChatGPT the badge is installed, then ask it to check progress.

Use details you can share publicly. Anyone with the submission ID can read the draft and its status. Your website must pass the ownership, badge, and content checks before publication.

Replace the project URL below, then copy this ChatGPT prompt.

YOUR AGENT PROMPT
Use the connected SubmitBy AI tools to submit my project with a free badge.

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

Use only public project details. Explain that the draft details and status are visible to anyone with its submission ID.

Read get_taxonomy and suggest a category and tags. Create the draft with submit_project and a fresh random request_key. Reuse that key only for identical retries.

Show me the exact badge HTML from get_badge. Wait until I have installed it on my website before calling verify_submission. Wait for retry_after, then use get_submission_status to read progress. Do not repeatedly queue verification.

Explain any action I must take. Give me the public listing URL only after the status is published.

What if the badge check fails?

Put the exact code on the submitted page. Keep the badge visible in server-rendered HTML. A badge from another submission cannot prove control of your website. Ask ChatGPT for the returned next action.

What if my website redirects?

Use the final HTTPS address. If verification reports a different origin, create a new draft for that address with a new request key.

When will my project appear?

ChatGPT shows a public listing link after the status becomes published. Some submissions need human review. Follow the returned retry time while checks run.

Can I pay to skip the badge in ChatGPT?

This ChatGPT connection supports the free badge route. Use the standard MCP or API flow on this page for the paid route. Read the listing prices before you choose.

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

Pay through your authorized MPP agent or open a secure Stripe Checkout link. Checkout shows any local currency conversion. The payment terms explain the seller and tax treatment for each method.

Terms and refunds

4. Verify and get discovered

An icon is optional. Supply an icon URL, or we will use your website’s first Apple touch icon, then its favicon. If no image loads, we show a default icon.

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

The directory shows your listing after the publication checks pass. API drafts stay private. ChatGPT draft details and status are visible to anyone with the submission ID. A payment only replaces the badge requirement.

Claim a listing we added

We add some useful projects from public information. Their page shows a listing ID and says that submitby.ai added it. To claim one, ask your agent to call recover_submission with that ID, add the returned file to your website, and call it again with the recovery_id. Your agent then receives a control token and can update the listing. Claimed listings do not need a badge.

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.

Agents with an authorized MPP payment client can request method: "mpp". Follow the returned payment challenge. Direct MPP purchases are sold by submitby.ai. Hosted Managed Checkout purchases are sold through Link.

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. Use POST /api/v1/submissions/:id/payment for MPP. When MPP is disabled, that endpoint can return hosted Checkout instead.

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