Skip to main content
Glama
citable-mcp

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.

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

  1. The tool requests the endpoint. Citable answers 402 with the price, the USDC mint and the pay-to address.

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

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

Available Tools

19 tools
citable_ai_mentions_trendCitable — monthly AI-mention trend for a domainA
Read-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_share_of_voiceCitable — AI share of voice across a competitive setA
Read-only

Paid ($0.18 USDC per call, whatever the set size). Compare 2–10 domains inside the AI-answer index: mentions, AI search volume, and each domain's share of the compared set, with per-engine and per-language splits. Share is of the set you asked about, not of the whole index. Not charged on failure.

Inputs: domains (required), platform.

citable_ai_visibilityCitable — AI-visibility checkA
Read-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_citability_reportCitable — full citability report (bundle)A
Read-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 forA
Read-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 monthA
Read-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 forA
Read-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 footprintA
Read-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 seedA
Read-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 & difficultyA
Read-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 callA
Read-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 suggestionsA
Read-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 auditA
Read-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 pricesA
Read-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 checkA
Read-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 pageA
Read-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 domainA
Read-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

    A4.2/5.0

    Scored across 19 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Exposes 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.
      5
      67 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides 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.
      11
      248 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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