The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Citable MCP listing page.
MCP server for Citable — SEO and AI-visibility data an agent can buy by the call. Each tool pays for itself in USDC on Solana over x402 from a wallet on your machine: no account, no API key, no subscription. $0.005–0.30 per call, and a failed call is never charged.
The code that signs those payments is in this repo — server.ts is the whole server.
Cursor, Claude Desktop, or any MCP client — mcp.json:
Node ≥ 20.18, or bunx citable-mcp.
The server gives the agent the tools; the open-source
skills pack teaches it the workflows —
a guided start, citability audits that apply fixes in your code, keyword briefs, rank
tracking with history in your repo, AI-citation checks, and a full-check that runs end to
end under one budget consent. 13 skills, 5 of them free.
Start with citable_prices — it reports the wallet, its balance, and how to fund it. Two ways:
citable_connect returns a link: sign in at citable.run with
Google or email, add a few dollars, click Connect. The agent then pays from that wallet.~/.config/citable/agent.json on first need and shows the address. Send it USDC on Solana —
no SOL required, the x402 facilitator covers the network fee — or point CITABLE_WALLET at
a funded keypair.Walkthrough: https://citable.run/docs/wallet
| Env | Default | Meaning |
|---|---|---|
CITABLE_WALLET | ~/.config/citable/agent.json | keypair JSON path, or the JSON byte array itself, holding mainnet USDC. Created when first needed |
CITABLE_MAX_PRICE | 0.30 | refuse any single call priced above this many USD; nothing is signed |
CITABLE_API | https://citable.run | base URL |
| Tool | Price | Returns |
|---|---|---|
citable_prices | free | endpoints, prices, wallet, balance, spend cap — call this first |
citable_connect | free | a sign-in link for funding without touching crypto |
citable_keyword_suggest | $0.005 | autocomplete expansions and questions for a seed |
citable_serp | $0.008 | the Google results page for a keyword |
citable_onpage_audit | $0.01 | citability score for one URL, 20 checks, ordered fixes |
citable_rank_check | $0.012 | where a domain ranks on Google for a keyword, plus the top 10 |
citable_keyword_metrics | $0.03 | volume, CPC, competition, difficulty and intent for 1–20 keywords |
citable_domain_overview | $0.03 | a domain's organic footprint: keywords ranked, top positions, traffic |
citable_domain_history | $0.03 | that footprint month by month |
citable_domain_keywords | $0.04 | the keywords a domain ranks for, with month-over-month movement |
citable_keyword_ideas | $0.05 | related keywords for a seed, with volume and difficulty |
citable_ai_visibility | $0.05/engine | which AI engines cite a domain for your question, and who they cite instead |
citable_keyword_research | $0.06 | one seed → keywords and questions, merged and priced |
citable_backlinks | $0.10 | backlink totals, referring domains, domain rank |
citable_ai_mentions_trend | $0.18 | monthly AI mentions for a domain, with the trend |
citable_ai_share_of_voice | $0.18 | 2–10 domains compared inside the AI-answer index |
citable_top_cited_pages | $0.22 | the domain's pages AI answers cite most |
citable_cited_prompts | $0.25 | the real questions AI engines already cite a domain for |
citable_citability_report | $0.30 | audit + AI visibility + top cited pages in one call ($0.43 apart) |
Every paid result carries _payment.transaction, the on-chain settlement. A call above the
cap, or without funds, returns a structured error and pays nothing.
402 with the price, the USDC mint and
the pay-to address.CITABLE_MAX_PRICE — and retries with the payment header.200.The keypair is read from disk and used only to sign these transfers. Nothing else leaves your machine, and Citable stores nothing about you: the wallet is the only identity.
MIT.