citable-mcp

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      # Codex

Cursor, 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.

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_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
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.

How a call works

• The tool requests the endpoint. Citable answers 402 with 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 bin

MIT.