{
  "markdown": "<div align=\"center\">\n\n<img src=\"assets/logo.svg\" width=\"120\" alt=\"sistrix-mcp logo\"/>\n\n# sistrix-mcp\n\n**Talk to your SISTRIX SEO data.** From Claude, Cursor, VS Code, or any MCP client.\n\n[![CI](https://github.com/Liohtml/sistrix-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Liohtml/sistrix-mcp/actions/workflows/ci.yml)\n[![Crates.io](https://img.shields.io/crates/v/sistrix-mcp.svg)](https://crates.io/crates/sistrix-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Rust](https://img.shields.io/badge/rust-1.88%2B-orange.svg)](https://www.rust-lang.org)\n[![MCP](https://img.shields.io/badge/MCP-compatible-8A2BE2)](https://modelcontextprotocol.io)\n\n*17 curated, credit-aware SEO tools + a full-API escape hatch. Single binary, instant startup, context-friendly.*\n\n[Quickstart](#-quickstart) · [Clients](#-connect-your-client) · [Tools](#-tools) · [Credits](#-api-credits) · [Configuration](#%EF%B8%8F-configuration) · [FAQ](#-troubleshooting)\n\n</div>\n\n---\n\n```text\nYou  ▸ How is example.com doing in Google — and who is beating us?\n\nClaude ▸ example.com's visibility index is 4.82 (Germany), up 6% over the last\n         8 weeks. It ranks for 18,400 organic keywords, 2,100 in the top 10.\n         Closest SEO competitors: competitor-a.de (74% overlap),\n         competitor-b.com (61%). Biggest opportunity: 312 keywords sit on\n         page 2 — want the top 20 by potential gain?\n```\n\nEvery question the SISTRIX Toolbox can answer, your AI assistant can now answer too — including follow-ups, comparisons, and \"why?\".\n\n## ✨ Why sistrix-mcp?\n\n| | |\n|---|---|\n| 🎯 **Curated, not generated** | 17 hand-crafted tools modeled on real SEO questions — not 90+ auto-generated API mirrors that flood the model's context and degrade tool selection. |\n| 🧭 **Guided workflows** | Four MCP prompts (SEO health check, keyword research, competitor comparison, AI visibility report) run a complete credit-aware analysis with one click. |\n| 💳 **Credit-aware** | SISTRIX bills most API calls per returned row from a weekly credit budget. Every tool ships tight row limits, cost notes in the descriptions, and a free `sistrix_credits` balance check — so one question never burns your week. |\n| ⚡ **Instant startup** | No introspection round-trips. One static binary, no Node, no Python, no runtime. Starts in milliseconds. |\n| 🔒 **Safe by default** | API key sent via POST body only (never in URLs/logs), redacted from every error message. |\n| 🧠 **Context-friendly** | Row limits on every report and a hard response budget with actionable guidance — one tool call can never blow up the context window. |\n| 🤖 **AI visibility included** | SISTRIX's newest data: which brands, entities, and sources ChatGPT, Perplexity, and Google AI Overviews actually cite (`sistrix_ai_*`). |\n| 🛒 **Amazon included** | Marketplace data by ASIN: rankings, price history, reviews (`sistrix_amazon`). |\n| 🧰 **Never a cage** | `sistrix_api` reaches **any** documented API method (ai.check, marketplace.keyword.*, project.onpage.*, …) when the curated tools don't cover it. |\n| 🔁 **Resilient** | Automatic retries with backoff on 429/5xx/network hiccups. Every documented SISTRIX error code mapped to a hint the model can act on. |\n\n## 🚀 Quickstart\n\n### 1. Install\n\n**Prebuilt binary** (Linux, macOS, Windows) — grab it from [Releases](https://github.com/Liohtml/sistrix-mcp/releases), or:\n\n```bash\n# Cargo\ncargo install sistrix-mcp\n\n# From source\ncargo install --git https://github.com/Liohtml/sistrix-mcp\n\n# Docker\ndocker pull ghcr.io/liohtml/sistrix-mcp\n```\n\n### 2. Get a SISTRIX API key\n\n[app.sistrix.com/account/api](https://app.sistrix.com/account/api) → create a key.\nAPI access is included from the **Plus** package onwards and uses a weekly credit budget.\n\n### 3. Verify the connection\n\n```bash\nsistrix-mcp --api-key YOUR_KEY --check\n```\n\n```text\n✓ Connected — 10000 API credits available\n```\n\n### 4. Connect your client ⬇\n\n## 🔌 Connect your client\n\n<details>\n<summary><b>Claude Code</b></summary>\n\n```bash\nclaude mcp add sistrix \\\n  --env SISTRIX_API_KEY=YOUR_KEY \\\n  --env SISTRIX_COUNTRY=de \\\n  -- sistrix-mcp\n```\n\n</details>\n\n<details>\n<summary><b>Claude Desktop</b></summary>\n\nAdd to `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\\Claude\\`):\n\n```json\n{\n  \"mcpServers\": {\n    \"sistrix\": {\n      \"command\": \"sistrix-mcp\",\n      \"env\": {\n        \"SISTRIX_API_KEY\": \"YOUR_KEY\",\n        \"SISTRIX_COUNTRY\": \"de\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Cursor</b></summary>\n\n`.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):\n\n```json\n{\n  \"mcpServers\": {\n    \"sistrix\": {\n      \"command\": \"sistrix-mcp\",\n      \"env\": {\n        \"SISTRIX_API_KEY\": \"YOUR_KEY\",\n        \"SISTRIX_COUNTRY\": \"de\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>VS Code (GitHub Copilot)</b></summary>\n\n`.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"sistrix\": {\n      \"type\": \"stdio\",\n      \"command\": \"sistrix-mcp\",\n      \"env\": {\n        \"SISTRIX_API_KEY\": \"${input:sistrix-key}\",\n        \"SISTRIX_COUNTRY\": \"de\"\n      }\n    }\n  },\n  \"inputs\": [\n    {\n      \"id\": \"sistrix-key\",\n      \"type\": \"promptString\",\n      \"description\": \"SISTRIX API key\",\n      \"password\": true\n    }\n  ]\n}\n```\n\n</details>\n\n<details>\n<summary><b>Windsurf / Zed / other MCP clients</b></summary>\n\nAny client that speaks MCP over stdio works with the generic shape:\n\n```json\n{\n  \"command\": \"sistrix-mcp\",\n  \"args\": [],\n  \"env\": {\n    \"SISTRIX_API_KEY\": \"YOUR_KEY\",\n    \"SISTRIX_COUNTRY\": \"de\"\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Docker (any client)</b></summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"sistrix\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-e\", \"SISTRIX_API_KEY\", \"-e\", \"SISTRIX_COUNTRY\",\n        \"ghcr.io/liohtml/sistrix-mcp\"\n      ],\n      \"env\": {\n        \"SISTRIX_API_KEY\": \"YOUR_KEY\",\n        \"SISTRIX_COUNTRY\": \"de\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n> [!TIP]\n> Set `SISTRIX_COUNTRY` (e.g. `de`) and every tool call automatically uses that\n> country index unless the model asks for another one.\n\n## 🧭 Tools\n\n| Tool | Answers questions like | Credits* |\n|------|------------------------|----------|\n| `sistrix_credits` | *\"How many API credits do we have left?\"* | free |\n| `sistrix_lists` | *\"Which country indices / SERP features / AI models exist?\"* | free |\n| `sistrix_domain_overview` | *\"How is example.com doing overall?\"* | 5 flat |\n| `sistrix_visibility` | *\"Visibility index trend over the last year? All-time high?\"* | 1/row |\n| `sistrix_keyword_counts` | *\"How many keywords do we rank for? Top-10 trend?\"* | 1/row |\n| `sistrix_competitors` | *\"Who are our closest SEO / Ads competitors?\"* | 1/row |\n| `sistrix_keyword_ideas` | *\"Which keywords are just off page 1 with the biggest potential?\"* | 1/row |\n| `sistrix_domain_structure` | *\"Which URLs/subdomains/directories drive our visibility?\"* | 1/row |\n| `sistrix_domain_rankings` | *\"All keywords we rank for on page 2, with traffic.\"* | 1/row |\n| `sistrix_keyword` | *\"Volume, CPC, intent, SERP features for 'ergonomic chair'?\"* | 1–5/row |\n| `sistrix_links` | *\"How does our backlink profile look? Top link texts?\"* | 1/row–25 flat |\n| `sistrix_ai_top` | *\"Which brands does AI mention most in our market?\"* | 1/row |\n| `sistrix_ai_entity` | *\"How do ChatGPT & Co. see our brand? Which sources do they cite?\"* | 1/row–10 flat |\n| `sistrix_ai_tracker` | *\"How visible are we in our tracked AI prompts vs. competitors?\"* | 1/row |\n| `sistrix_project` | *\"Optimizer project rankings, onpage crawl results, tracked SERPs.\"* | varies |\n| `sistrix_amazon` | *\"Amazon rankings, price and review history for this ASIN.\"* | 1/row |\n| `sistrix_api` | Everything else — `ai.check.*`, `marketplace.keyword.*`, `project.onpage.*`, any documented method | varies |\n\n<sub>*Costs as documented by SISTRIX per method; see [API credits](#-api-credits).</sub>\n\nDomain tools accept a `target` (the domain, host, path, or URL) plus a `scope`\nthat tells SISTRIX how to interpret it, a `country` index, and a row `limit`.\n\n### Guided workflows (MCP prompts)\n\nFour ready-made analysis workflows ship as MCP prompts — clients like Claude\nsurface them as one-click commands. Each runs a proven, credit-aware tool\nsequence and ends in a structured report:\n\n| Prompt | Arguments | What you get |\n|--------|-----------|--------------|\n| `seo_health_check` | `target`, `country?` | Full status: key figures, trend, competitors, quick wins, next actions |\n| `keyword_research` | `keyword`, `country?` | Metrics, intent, SERP features, questions, who ranks — plus a verdict |\n| `competitor_comparison` | `target`, `competitor`, `country?` | Side-by-side comparison and 3 concrete moves to close the gap |\n| `ai_visibility_report` | `brand`, `country?` | How ChatGPT & Co. see the brand: competitors, prompts, cited sources |\n\n### Prompts to try\n\n- *\"Give me an SEO health check for example.com in Germany.\"*\n- *\"Which keywords sit on positions 11–20 with the most traffic potential?\"*\n- *\"Compare our visibility trend with competitor-a.de over the last 12 months.\"*\n- *\"Does ChatGPT recommend our brand? Which sources does it cite in our niche?\"*\n- *\"What's the search intent and CPC for our top 10 money keywords?\"*\n\n## 💳 API credits\n\nSISTRIX API access starts with the **Plus** package and uses a **weekly** credit\nbudget. Most methods cost **1 credit per returned row**; a few are flat-rate\n(`domain.overview` = 5, `domain.visibilityindex.overview` = 10,\n`links.overview` = 25) and `keyword.seo.metrics` costs 5 per keyword.\n\nsistrix-mcp defaults every list to **25 rows** (not SISTRIX's 100–10,000) and\ntells the model what each call costs, so exploratory conversations stay cheap.\nCheck the balance anytime with `sistrix_credits` — it's free, as are\n`sistrix_lists` and the project/tracker list reports.\n\nThe rate limit is 300 requests/minute; sistrix-mcp backs off and retries\nautomatically when it's hit.\n\n## ⚙️ Configuration\n\n| Flag | Env | Default | Description |\n|------|-----|---------|-------------|\n| `--api-key` | `SISTRIX_API_KEY` | — *(required)* | SISTRIX API key ([create here](https://app.sistrix.com/account/api)) |\n| `--country` | `SISTRIX_COUNTRY` | account default | Default country index (e.g. `de`, `at`, `us`) for all country-aware tools |\n| `--timeout-secs` | `SISTRIX_TIMEOUT_SECS` | `30` | Per-request timeout |\n| `--max-response-chars` | `SISTRIX_MAX_RESPONSE_CHARS` | `50000` | Response budget before truncation |\n| `--api-url` | `SISTRIX_API_URL` | `https://api.sistrix.com/` | API endpoint (testing only) |\n| `--check` | — | — | Verify the API key, print remaining credits, then exit |\n\n## 🆚 How is this different from SISTRIX's official MCP integration?\n\nSISTRIX [documents its own MCP bridge](https://www.sistrix.com/api/connection-to-chatbot-ai/)\nfor connecting chatbots to the API — and per their docs, requests through it\ncurrently don't count against the credit quota. If that covers your needs, use it!\n\nsistrix-mcp is the open-source, self-hosted alternative: a local stdio binary\nwith a curated, fully documented tool surface (17 tools with exact schemas,\nenums, and per-case validation), an escape hatch to **every** documented API\nmethod including the newest areas (`ai.check`, marketplace, Optimizer onpage),\nhard response budgets for the model's context, offline tests, and no dependency\non a hosted bridge. MIT-licensed, so you can read exactly what the model can and\ncannot do with your API key.\n\n## 🩺 Troubleshooting\n\n<details>\n<summary><b>\"wrong api key\" (code 100)</b></summary>\n\nRun `sistrix-mcp --api-key ... --check`. If it fails, regenerate the key under\n[app.sistrix.com/account/api](https://app.sistrix.com/account/api).\n\n</details>\n\n<details>\n<summary><b>\"not enough credits\" (code 200)</b></summary>\n\nThe weekly budget is exhausted. Credits refill weekly; check the balance with\n`sistrix_credits`. Keep `limit` small — most tools cost 1 credit per row.\n\n</details>\n\n<details>\n<summary><b>\"package does not contain api access\" (code 5000)</b></summary>\n\nAPI access starts with the SISTRIX **Plus** package. Check your plan.\n\n</details>\n\n<details>\n<summary><b>\"domain not found\" (code 2000)</b></summary>\n\nThe domain isn't in the SISTRIX database for the chosen country index. Try\nanother `country`, or check the spelling.\n\n</details>\n\n<details>\n<summary><b>Responses feel truncated</b></summary>\n\nThat's the context guard doing its job. Ask for fewer rows or raise\n`--max-response-chars`.\n\n</details>\n\n## 🏗️ Development\n\n```bash\ngit clone https://github.com/Liohtml/sistrix-mcp.git\ncd sistrix-mcp\ncargo test                                  # 59 offline tests, no SISTRIX account needed\ncargo clippy --all-targets -- -D warnings\ncargo run -- --api-key YOUR_KEY --check\n```\n\nSee [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for the design, and\n[docs/sistrix-api-reference.md](docs/sistrix-api-reference.md) for a complete,\ncrawled reference of the SISTRIX API (all 91 methods with parameters and\ncredit costs).\n\nContributions welcome — see [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## 📄 License\n\n[MIT](LICENSE) © Lionel Machire\n\n- MCP Registry name: `mcp-name: io.github.Liohtml/sistrix-mcp`\n- Also listed on Glama:\n\n<a href=\"https://glama.ai/mcp/servers/Liohtml/sistrix-mcp\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/Liohtml/sistrix-mcp/badge\" alt=\"sistrix-mcp on Glama\" />\n</a>\n\n*Not affiliated with or endorsed by SISTRIX GmbH. SISTRIX is a trademark of SISTRIX GmbH.*\n",
  "bytes": 13535,
  "sha": "203bfc77d872653349a408dbea0292ab9758a27768efc69357255e22be0363b6",
  "repo_slug": "liohtml/sistrix-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_liohtml_sistrix_mcp_9210d9eb/readme"
}