zaialamm/citable-mcp

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.
Install
Cursor, Claude Desktop, or any MCP client — mcp.json:
Node ≥ 20.18, or bunx citable-mcp.
Skills
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.
Wallet
Start with citable_prices — it reports the wallet, its balance, and how to fund it. Two ways:
- **Sign in, no crypto needed.** 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.
- **Keypair, if you already use Solana.** With nothing configured the server creates
~/.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
Config
| 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 |
Tools
| 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 |