For AI agents

Let your AI agent list your tool

Claude, ChatGPT, Cursor and other agents can search 1ai.tools and submit your AI tool for you. Same rules as the web form: policy checks, human review, and free with a link to us or $6 a year without one.

Get an API key

Connect your agent

Add the Agent Skill, the MCP server, or call the REST API. Searching needs no key.

Ask it to list your tool

“Submit my tool example.ai to 1ai.tools.” The agent submits, then tells you the next step: add a link, or pay.

Get an API key Download SKILL.md OpenAPI spec

Option A · Agent Skill

For Claude (claude.ai, Claude Code) and other agents that load skills. Save the file as SKILL.md in a folder named 1ai-tools, then add the folder to your skills (Claude Code: ~/.claude/skills/1ai-tools/SKILL.md).

mkdir -p ~/.claude/skills/1ai-tools
curl -o ~/.claude/skills/1ai-tools/SKILL.md https://www.1ai.tools/skill.md

Any chat agent can also read it from the link: “Read https://www.1ai.tools/skill.md and submit my tool.”

Option B · MCP server

Remote MCP server (Streamable HTTP) at https://www.1ai.tools/api/mcp. Tools: search_tools, get_tool, submit_tool, list_my_submissions, get_submission, verify_backlink, get_payment_link. Search works without a key.

Claude Code

claude mcp add --transport http 1ai-tools https://www.1ai.tools/api/mcp --header "Authorization: Bearer 1ai_YOUR_KEY"

Cursor, Windsurf and other clients (mcp.json)

{
  "mcpServers": {
    "1ai-tools": {
      "url": "https://www.1ai.tools/api/mcp",
      "headers": {
        "Authorization": "Bearer 1ai_YOUR_KEY"
      }
    }
  }
}

Claude.ai / Claude Desktop

Settings → Connectors → Add custom connector → paste https://www.1ai.tools/api/mcp.

Option C · REST API

Base URL https://www.1ai.tools/api/v1. Full reference in the OpenAPI spec.

# Search (no key)
curl "https://www.1ai.tools/api/v1/tools?q=video&limit=5"

# Submit your tool
curl -X POST "https://www.1ai.tools/api/v1/submissions" \
  -H "Authorization: Bearer 1ai_YOUR_KEY" -H "content-type: application/json" \
  -d '{"url":"https://example.ai","accept_guidelines":true,"listing_type":"backlink"}'

# Check the link to us, or get the payment link
curl -X POST "https://www.1ai.tools/api/v1/submissions/ID/backlink" -H "Authorization: Bearer 1ai_YOUR_KEY" \
  -H "content-type: application/json" -d '{"url":"https://example.ai/"}'
curl -X POST "https://www.1ai.tools/api/v1/submissions/ID/checkout" -H "Authorization: Bearer 1ai_YOUR_KEY"

Rules for agents

Submit only tools the user owns or represents, after they accept the guidelines and terms.
Every submission goes through the same policy checks and human review as the web form.
Agents never pay. A paid listing returns a Stripe link for the user.
Limits: 5 submissions per minute per address, 60 reads per minute.

Read the directory as data

/llms.txt (index), /llms-full.txt (every tool), and a Markdown page per tool at /md/<slug>.