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.

Looking for research instead of submission? The MCP server also exposes anonymous tools for tool profiles, comparisons, alternatives and live deals — see the MCP install guide.

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 — Hosted MCP server (no install, no token for research)

Connect any MCP client to the remote server. The research tools (search_tools, get_tool, compare_tools, find_alternatives, list_deals) need no account. Submission tools are not exposed here: they need a credential bound to your account, so they run on the local server in Option B until OAuth sign-in lands.

{
  "mcpServers": {
    "altimateguide": {
      "type": "http",
      "url": "https://altimateguide.com/api/mcp"
    }
  }
}

Per-client commands for Claude Code, Codex, Gemini CLI, VS Code, Cursor, Claude and ChatGPT: MCP install guide (markdown).

Option B — Local MCP server (npx)

Same tool surface, run locally — required for submissions until OAuth sign-in lands, because the token comes from this process's environment.

{
  "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 C — 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
nonenofollowwithin 30 days

The fastest route is paid — one-time $14.99, no badge or wall to install, reviewed ahead of free requests. Call upgrade_listing with path: "paid" (or POST /api/agent/listing) and it returns a checkout URL for the human to complete; the link becomes dofollow once the payment is verified server-side.

Already submitted with proof: "none"? The submission response and get_submission include a machine-readable upgrade hint with recommended: "paid" and the free alternatives. Both responses carry review_eta.

3. Submit a deal

A deal is a time-boxed offer attached to a listing — a lifetime deal, a sale, or a launch price. Deals have their own lane and their own turnaround, and they appear on /deals once approved.

MCP: call submit_deal with the product, the deal page URL, the price, and an optional end date. HTTP: POST /api/agent/deals with the same fields. The response includes review_eta, needs_listing (true when the product isn't listed yet) and link_tier: "unchanged".

Deal laneTriggerReview
Paidpayment_ref presentwithin 2 business days
Freeno payment refwithin 7 days

A deal never changes a listing's link tier. Dofollow is earned through the listing paths above; submitting a deal can't grant it. endsAt is optional — omit it for an open-ended offer, which then stays live while its last verification is under 30 days old.

What happens next

Submissions land in the moderation queue with a neutral-language gate. Paid listings (within 2 business days) and verified proofs (a live SayAbout.Us wall, within 2 business days; a badge, in 5–7 business days) may earn a dofollow link once approved. Free no-verification submissions stay nofollow and are reviewed within 30 days.

Submitting by hand instead? See request inclusion or, with no proof, the free listing page.