citable-mcp
An MCP server that gives AI agents paid, per-call SEO and AI-visibility data, settled in USDC on Solana with no API keys or subscriptions.
Check prices, wallet balance, and funding options (citable_prices, citable_connect)
Explore keywords: suggestions, questions, metrics, research, ideas, and raw SERPs
Audit a page for on-page SEO issues and citability fixes
Check Google rankings and analyze domain keyword footprints, history, and backlinks
Measure AI visibility: which engines cite a domain, top cited pages, cited prompts, mention trends, and share of voice
Run a bundled citability report combining audit, AI visibility, and top cited pages in one call
Allows retrieving Google search engine results pages (SERP) for a keyword, including top rankings and domain positions.
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
claude mcp add citable -- npx -y citable-mcp # Claude Code
codex mcp add citable -- npx -y citable-mcp # CodexCursor, Claude Desktop, or any MCP client — mcp.json:
{
"mcpServers": {
"citable": {
"command": "npx",
"args": ["-y", "citable-mcp"],
"env": { "CITABLE_MAX_PRICE": "0.30" }
}
}
}Node ≥ 20.18, or bunx citable-mcp.
Related MCP server: @seodesignlab/mcp-server
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.
npx skills add zaialamm/seo-ai-visibility-skills # any agent: Codex, Cursor, Gemini CLI, 17+
/plugin marketplace add zaialamm/seo-ai-visibility-skills # Claude Code plugin (bundles this server)Wallet
Start with citable_prices — it reports the wallet, its balance, and how to fund it. Two ways:
Sign in, no crypto needed.
citable_connectreturns 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.jsonon first need and shows the address. Send it USDC on Solana — no SOL required, the x402 facilitator covers the network fee — or pointCITABLE_WALLETat a funded keypair.
Walkthrough: https://citable.run/docs/wallet
Config
Env | Default | Meaning |
|
| keypair JSON path, or the JSON byte array itself, holding mainnet USDC. Created when first needed |
|
| refuse any single call priced above this many USD; nothing is signed |
|
| base URL |
Tools
Tool | Price | Returns |
| free | endpoints, prices, wallet, balance, spend cap — call this first |
| free | a sign-in link for funding without touching crypto |
| $0.005 | autocomplete expansions and questions for a seed |
| $0.008 | the Google results page for a keyword |
| $0.01 | citability score for one URL, 20 checks, ordered fixes |
| $0.012 | where a domain ranks on Google for a keyword, plus the top 10 |
| $0.03 | volume, CPC, competition, difficulty and intent for 1–20 keywords |
| $0.03 | a domain's organic footprint: keywords ranked, top positions, traffic |
| $0.03 | that footprint month by month |
| $0.04 | the keywords a domain ranks for, with month-over-month movement |
| $0.05 | related keywords for a seed, with volume and difficulty |
| $0.05/engine | which AI engines cite a domain for your question, and who they cite instead |
| $0.06 | one seed → keywords and questions, merged and priced |
| $0.10 | backlink totals, referring domains, domain rank |
| $0.18 | monthly AI mentions for a domain, with the trend |
| $0.18 | 2–10 domains compared inside the AI-answer index |
| $0.22 | the domain's pages AI answers cite most |
| $0.25 | the real questions AI engines already cite a domain for |
| $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.
How a call works
The tool requests the endpoint. Citable answers
402with the price, the USDC mint and the pay-to address.The server signs a USDC transfer for exactly that amount — only if it is at or below
CITABLE_MAX_PRICE— and retries with the payment header.The facilitator settles on Solana in about 400 ms and the endpoint returns
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.
Build
bun install
bun build.ts # → dist/server.js, the published binMIT.
Available Tools
19 toolscitable_ai_mentions_trendCitable — monthly AI-mention trend for a domainARead-only
Paid ($0.18 USDC per call). Stateless prompt tracking: monthly AI mentions and AI search volume for a domain with month-over-month deltas and a direction summary. No tracker to create and nothing to poll — one call returns the whole series. The index starts 2025-08-01. Not charged on failure.
Inputs: domain (required), to, from, platform.
citable_ai_visibilityCitable — AI-visibility checkARead-only
Paid ($0.05 USDC per engine asked; $0.20 for all four). Asks the AI answer engines (Perplexity, Gemini, OpenAI, Claude — whichever the deployment has configured) a prompt through their official APIs and reports which ones cite the domain: mentioned, 1-based position in each engine's citation list, and the full cited-domain list per engine. One run per engine — answers vary between runs, so call 2–3 times for signal. Not charged if no engine answers.
Inputs: domain (required), prompt (required), engines.
citable_backlinksCitable — backlink profile and top referring domainsARead-only
Paid ($0.10 USDC per call). Link profile in one call: total backlinks, referring domains, domain rank, broken links and nofollow share, plus the top referring domains with first-seen dates. The link-prospecting starting point. Not charged on failure.
Inputs: domain (required), limit.
citable_citability_reportCitable — full citability report (bundle)ARead-only
Paid ($0.30 USDC per call; $0.43 bought separately). One call bundles the on-page citability audit, AI visibility across all configured engines, and the domain's top AI-cited pages. Answers: can AI read this site, who cites it today, and which pages already work. Not charged on failure.
Inputs: domain (required), prompt (required), limit.
citable_cited_promptsCitable — prompts a domain is already cited forARead-only
Paid ($0.25 USDC per call). The real questions AI answer engines cite a domain for, from an aggregated index of AI answers — question, answer snippet, AI search volume, and the exact URL cited. These are observed prompts, never generated ones, so use this to discover what to track instead of inventing them. Repeated observations of one question are collapsed, with observations counting them. Point it at a competitor's domain to get the prompts they win and you do not. Not charged on failure.
Inputs: domain (required), limit, platform.
citable_connectCitable — connect a sign-in wallet (no crypto needed)A
Free. For people who do not use crypto. Returns a link to open in a browser: sign in at Citable with Google or email, add a few dollars of USDC, click Connect — the agent then pays from that wallet. The link works for 15 minutes; when the user says it is done, call citable_prices to confirm (walletMode becomes sign-in). {status:true} only reports; {reset:true} disconnects and returns to the keypair. The first connect installs Para's SDK under ~/.config/citable/para (about 200 MB, once).
Inputs: reset, status.
citable_domain_historyCitable — a domain's footprint month by monthARead-only
Paid ($0.03 USDC per call). How a domain's organic footprint has moved, month by month (up to months; the current month may be partial), from the ranking index: keywords ranked, top-10 count, estimated traffic and value, and how many keywords were new, up, down or lost each month, plus a first-to-last trend. The stateless way to track rankings — nothing is stored, the index keeps the history. Monthly resolution; for one keyword's position today use citable_rank_check. Not charged on failure.
Inputs: domain (required), lang, months, country.
citable_domain_keywordsCitable — the keywords a domain ranks forARead-only
Paid ($0.04 USDC per call). The keywords a domain actually ranks for — volume, CPC, position, month-over-month movement (previousPosition, change, status) and the ranking URL, highest volume first, with the index's total count. Point it at a competitor for their playbook. Not charged on failure.
Inputs: domain (required), lang, limit, country.
citable_domain_overviewCitable — domain organic footprintARead-only
Paid ($0.03 USDC per call). One domain's organic footprint from a ranking index: keywords ranked, top-3/top-10 counts, estimated monthly traffic and its ad value, plus the paid-search side. The first call for any domain question; then citable_domain_keywords for what it ranks for. Not charged on failure.
Inputs: domain (required), lang, country.
citable_keyword_ideasCitable — keyword research from a seedARead-only
Paid ($0.05 USDC per call). Keyword research: one seed returns up to 100 keywords that contain it, each with search volume, CPC, competition, difficulty and intent, ordered by volume. Full-text matched, so results stay on topic. Use citable_keyword_suggest for the exact phrasings people type (no volume), and citable_keyword_metrics when you already have a shortlist. Not charged on failure.
Inputs: seed (required), lang, limit, country.
citable_keyword_metricsCitable — keyword volume & difficultyARead-only
Paid ($0.03 USDC per call, covers the whole batch). Search volume, CPC, competition, keyword difficulty and search intent for 1–20 keywords — licensed clickstream-derived estimates. Answers in request order; unknown keywords return null metrics. Pair with citable_keyword_suggest: expand a seed there, price the shortlist here. Not charged if the metrics feed is unavailable.
Inputs: keywords (required), lang, country.
citable_keyword_researchCitable — everything about one keyword, in one callARead-only
Paid ($0.06 USDC per call). One seed returns keywords AND questions, merged from public autocomplete and the paid keyword index, with search volume, CPC, difficulty and intent attached. Each row says which sources found it — both is the strongest signal. Cheaper than citable_keyword_ideas plus citable_keyword_metrics separately; reach for those only when you want to control exactly what you pay for. Not charged on failure.
Inputs: seed (required), lang, limit, country.
citable_keyword_suggestCitable — keyword suggestionsARead-only
Paid ($0.005 USDC per call). Expands a seed keyword into autocomplete suggestions, related queries and questions, deduped and ranked across Google, YouTube and Bing. Returns suggestions[] and questions[] with a 0–1 prominence score, the sources each came from, and whether the keyword still contains the seed.
Inputs: seed (required), lang, depth, limit, +2 more.
citable_onpage_auditCitable — on-page SEO auditARead-only
Paid ($0.01 USDC per call). Fetches one URL and returns a scored on-page audit: title, meta description, canonical, robots, viewport, lang, heading counts and text, word count, internal/external links, image alt coverage, Open Graph, JSON-LD types, HTTP details, and 15 weighted checks with a 0–100 score. Not charged if the page cannot be fetched.
Inputs: url (required).
citable_pricesCitable — endpoints and pricesARead-only
Free. Lists Citable's SEO endpoints with current per-call USDC prices, plus the wallet that pays: address (the one to fund), walletMode (keypair or sign-in), balanceUsdc and funded. When it is empty, setup gives the two ways to fund it — put them to the user. Call this first.
Inputs: no named parameters.
citable_rank_checkCitable — Google rank checkARead-only
Paid ($0.012 USDC per call). Google organic position of a domain for a keyword via a licensed SERP feed: 1-based position (null if outside the checked window), the ranking URL and title, plus the top-10 result list. Not charged if the feed is unavailable.
Inputs: domain (required), keyword (required), gl, hl, +1 more.
citable_serpCitable — raw Google results pageARead-only
Paid ($0.008 USDC per call). The raw Google results page for a keyword: organic results with snippets, plus People-Also-Ask questions and related searches when present. rank-check answers where am I; this answers what the page looks like. Not charged on failure.
Inputs: keyword (required), gl, hl, num.
citable_top_cited_pagesCitable — top AI-cited pages of a domainARead-only
Paid ($0.22 USDC per call). Which pages of a domain AI engines cite most, from an aggregated index of AI answers — per-page mentions, AI search volume, per-engine and per-language splits, plus domain totals. Answers 'what already works on this site — write more of that'. Not charged if the index is unavailable.
Inputs: domain (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
The tools are grouped into coherent families, but the four keyword tools and five AI-citation tools overlap in purpose and can be difficult to distinguish at a glance. The detailed cross-references help, but there are more potentially confusing pairs than the ideal.
All tools share the citable_ prefix and snake_case style, which creates a predictable pattern across the server. However, names mix noun-style analytics endpoints like citable_serp and citable_backlinks with verb-style actions like citable_connect and citable_keyword_suggest, so it is not a uniform verb_noun pattern.
19 tools is above the ideal 3-15 range, but the count is justified by the breadth of SEO and citability analytics plus the granular paid pricing model. Each endpoint earns its place; the server feels slightly heavy rather than bloated.
The tool surface covers the full domain: wallet setup, keyword discovery and metrics, SERP and rank checks, on-page audit, backlinks, AI visibility, top cited pages, cited prompts, trends, share of voice, and domain history. There are no obvious dead ends or missing core operations for a stateless analytics API.
Related MCP Connectors
5 pay-per-call SEO tools over MCP. Free discovery, tool calls settle in USDC on Base via x402.
Pay-per-call (x402/USDC-Base) web + crypto data tools for AI agents: audit, extract, crypto, DeFi.
Pay-per-call tools for AI agents: product photos, documents, web pages, data. USDC via x402.
Pay-per-call APIs built for AI agents: crypto market data, onchain checks, x402 tools, and the web and documents (web search, page fetch and extract, screenshots, PDF to text, an HTTP proxy, x402 marketplace search and pre-pay quotes). No API keys, no signup. Agents pay per call via x402 in USDC on Base.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceWebsite intelligence tools for AI agents. Ten pay-per-call tools via x402 micropayments (USDC on Base) — no accounts, no API keys.1MIT
- AlicenseAqualityDmaintenanceExposes professional SEO tools (content briefs, keyword research, SERP analysis, backlink profiles, and on-page audits) to MCP-compatible AI agents with automatic x402 micropayment handling on Base.567 npmMIT
- AlicenseAqualityBmaintenanceProvides AI agents with typed SEO tools for domain authority, keyword opportunities, competitor gap analysis, content briefs, site audits, and internal links, backed by Common Crawl graph data and optional x402 payment settlement.11248 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to run full on-page SEO audits for any URL or up to 10 URLs at once, returning 0-100 scores, meta tag and heading checks, schema/image/link analysis, load time, and prioritized fixes via pay-per-call x402 micropayments.MIT