Submit a tool to the Altimateguide directory for editorial review.
io.github.imharikumaran/altimateguide — MCP Server
This MCP server supports submitting a tool to the Altimateguide directory for editorial review. Its purpose is described as “Submit a tool to the Altimateguide directory for editorial review,” and it is identified by the slug io-github-imharikumaran-altimateguide.
🛠️ Key Features
Submit a tool to the Altimateguide directory for editorial review
🚀 Use Cases
Directory submissions where editorial review is required for tools
⚡ Developer Benefits
Provides a standardized way (via MCP) to route tool submissions to Altimateguide’s editorial review process
⚠️ Limitations
No additional capabilities, tool list, or operational details are provided in the available server data
A small MCP server that lets an AI agent submit a tool to the
Altimateguide directory for editorial review — and,
optionally, earn it a dofollow link.
Scope: this server only talks to the public Altimateguide HTTP API. It holds
no database credentials and grants no access beyond submitting/owning listings.
Nothing is published without an editor reviewing it, and no submission can
self-grant a dofollow link — a paid listing only becomes a dofollow candidate
once its payment is verified server-side.
Tools
Tool
What it does
start_login
Email a one-time login code (POST /api/auth/request-code).
complete_login
Exchange the code for an account API token and store it (POST /api/agent/token).
start_agentid_login
Begin an AgentID sign-in with no email inbox — returns an authorizeUrl + flowId (POST /api/agent/agentid/start).
complete_agentid_login
Poll the AgentID sign-in and store the account token once it completes (GET /api/agent/agentid/poll).
whoami
Report whether a token is configured locally.
list_categories
The valid category slugs (GET /api/agent/categories).
check_duplicate
Preflight a name/URL against published tools + the pending queue (GET /api/agent/check).
submit_tool
Submit a listing for editorial review (POST /api/agent/submit).
get_submission
Poll a submission's status (GET /api/agent/submissions/{id}).
update_listing
Edit the facts of a listing you own — only the fields you pass change (PATCH /api/agent/listing/{slug}).
get_listing_stats
Visits/upvotes/saves/reviews for your listings, with 7- and 30-day windows (GET /api/agent/stats).
upgrade_listing
Choose sayabout / badge / paid for a listing you own (POST /api/agent/listing).
It also exposes the category list and the editorial policy as resources, a
submit_listingprompt, and category-slug completions. Server
instructions summarise the workflow for the model.
submit_tool parameters
name (string, required) — tool name
url (string, required) — canonical http(s) URL
description (string, optional) — neutral copy, min 20 chars
categories (array, optional) — slugs from list_categories
categorySuggestions (array, optional) — free-text hints when none fit (recorded for the reviewer)
features (array, optional) — { label, description? } items
verificationUrl (string) — required for sayabout/badge
externalId (string, optional) — your id for idempotent replays (derived from the URL when omitted)
source (string, optional) — origin id (default agent:mcp)
resubmit (boolean, optional) — set true to send a fresh copy after a previous
submission for this URL was rejected (mints a new idempotency key instead of
replaying the rejected row)
Categories are optional. An unknown or missing category never fails the
submission — it is recorded for the reviewer, exactly like the site's feed
pipeline. Paid (dofollow) listings are not submitted here; use
upgrade_listing with path: "paid", which returns a Dodo checkout URL whose
payment is verified server-side.
ALTIMATEGUIDE_AGENT_TOKEN — optional. An account API token (create at
https://altimateguide.com/account, or mint one with the complete_login
tool). When set, it takes precedence over the stored token.
ALTIMATEGUIDE_API_URL — optional; overrides the API base (default
https://altimateguide.com).
ALTIMATEGUIDE_CONFIG_DIR — optional; where complete_login stores the token
(default ~/.config/altimateguide).
Install & use
bash
npx -y altimateguide-agent-mcp # run directly (stdio)
Or from a local checkout:
bash
npm install
npm run build # tsc -> dist/
npm run dev # stdio server via tsx (for local testing)
The token can be supplied via env.ALTIMATEGUIDE_AGENT_TOKEN, or obtained at
runtime by calling start_login + complete_login (the agent needs access to
the mailbox it registers).
(From a local checkout, use "command": "node" and
"args": ["/absolute/path/to/dist/index.js"].)
Development
bash
npm run check # tsc --noEmit
npm run lint # eslint
npm test# vitest
npm run build # tsc -> dist/
npm run bundle # build a .mcpb (Smithery / Claude Desktop)
Registries
Listed via server.json (the MCP Registry manifest). It is a standard stdio
server, so it also works with the community directories (Glama, PulseMCP,
mcp.so, mcp.directory).