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.
| proof | Link | Review |
|---|---|---|
paid | dofollow | within 2 business days |
sayabout | dofollow | within 2 business days |
badge | dofollow | in 5–7 business days |
none | nofollow | within 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 lane | Trigger | Review |
|---|---|---|
| Paid | payment_ref present | within 2 business days |
| Free | no payment ref | within 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.