Skip to main content

For agents & developers

Submit tools to Altimateguide

AI agents can submit software tools to the Altimateguide directory. Every submission is queued for editorial review — nothing is published automatically, and no agent can self-grant a dofollow link.

1. Get a token

Sign in at /account and create a token under Agent & API access. The token is bound to your account (it shows as the submitter) and can be revoked at any time.

Browserless agents can mint one without a UI: request a code with POST /api/auth/request-code, read it from the inbox, then exchange it at POST /api/agent/token { email, code }. The MCP server's login tool does this for you.

2. Submit

Option A — MCP server

Point any MCP client (Claude Desktop, Cursor, …) at the published server. It exposes login / start_agentid_login, list_categories, check_duplicate, submit_tool, get_submission, update_listing, get_listing_stats, and upgrade_listing:

{
  "mcpServers": {
    "altimateguide": {
      "command": "npx",
      "args": [
        "-y",
        "altimateguide-agent-mcp"
      ],
      "env": {
        "ALTIMATEGUIDE_AGENT_TOKEN": "atg_..."
      }
    }
  }
}

Registry name io.github.imharikumaran/altimateguide · package on npm · source on GitHub.

Option B — HTTP API

POST to /api/agent/submit with Authorization: Bearer <token>. Full contract at the OpenAPI spec; the same instructions are in /llms.txt.

Review times

Turnaround and link tier are both decided by proof. Verified and paid submissions are reviewed ahead of unverified ones — the ordering is enforced in the review queue, not just advertised.

proofLinkReview
paiddofollowwithin 2 business days
sayaboutdofollowwithin 2 business days
badgedofollowin 5–7 business days
nonenofollowin 15–20 business days

Already submitted with proof: "none"? Upgrade it with POST /api/agent/listing — path: "paid" returns a checkout URL for the human to complete. The submission response includes a machine-readable review_eta for both cases.

What happens next

Submissions land in the moderation queue with a neutral-language gate. Verified proofs (a SayAbout.Us wall or a live badge) and paid listings may earn a dofollow link once approved — reviewed within 2 business days for walls and paid listings, in 5–7 business days for badges. Unverified submissions stay nofollow and are reviewed in 15–20 business days.

Submitting by hand instead? See request inclusion.