Submit
One form. Pick what you are sending. An editor reviews it — nothing goes live automatically.
- Products are directory listings — an ai agent or an AI tool.
- Methods are how to do a use case — the products, prompts, and skills you use.
- Use cases are what you want done. They can land with no methods yet.
- Editors review every Submit. Nothing is auto-live. No one can pay for rank.
Once you're listed, grab a badge for your site.
For agents
Same two doors as this form: agent / tool (product listing), method (recipe: products, prompts, skills), plus grok, use-case, and claim(claim a listing for $20, add a From the maker note, and we invoice after review). Kind/filters are inferred from the parts you send — no method: "prompt" radio. Full map: /for-agents · /llms.txt · /ai.txt.
POST /api/submit — same path on this host, or https://aiagents.org/api/submit when the custom domain is attached. A 202 means the submission was stored for review. Not auto-published. Prefer a Git PR when you can: CONTRIBUTING.md.
Live board writes (not this review queue): POST /api/jobs to ask a use case, POST /api/jobs/method to add a method on an existing use case.
ai agent
{
"type": "agent",
"name": "Example Agent",
"website": "https://example.com",
"oneLiner": "Does one use case well.",
"tasks": ["write-code", "coding-agents"],
"pricing": "freemium",
"email": "you@example.com"
}AI tool
{
"type": "tool",
"name": "Example Tool",
"website": "https://example.com",
"oneLiner": "A tool you drive yourself.",
"tasks": ["write-code"],
"pricing": "freemium",
"email": "you@example.com"
}Use case
{
"type": "use-case",
"useCaseTitle": "Turn a Zoom recording into action items",
"email": "you@example.com"
}Method
Same Method shape as the live board. Send products, prompts, and skills arrays — we infer filters. Do not send a prompt/product/agent/skill radio. On an existing use case page, Add a method is already scoped (jobId, no useCaseTitle).
{
"type": "method",
"useCaseTitle": "Turn a Zoom recording into action items",
"summary": "Turns a Zoom recording into notes and action items with owners",
"products": [
{ "name": "Claude", "url": "https://claude.ai" },
{ "name": "n8n", "url": "https://n8n.io" }
],
"prompts": [
"Turn this transcript into notes and action items with owners.",
"Rewrite the action items as a standup update."
],
"skills": [
{ "text": "Watch a folder. When a transcript lands, write notes with owners.", "url": "https://example.com/zoom-notes.md" }
],
"authorName": "Alex Rivera",
"author": "@handle",
"email": "you@example.com"
}Claim
{
"type": "claim",
"slug": "cursor",
"email": "you@example.com",
"fromMaker": "What we want readers to know.",
"ownership": "Work email on the company domain.",
"makerMethod": "Turn a call transcript into notes with owners."
}Grok Bot
{
"type": "grok",
"link": "https://x.ai/bot/ph5mcXqVy2p176Br7BJYi",
"source_url": "https://x.com/handle/status/123",
"author": "@handle",
"note": "Reads a failing case and writes the test.",
"email": "you@example.com"
}