{
  "markdown": "# Miraqo MCP Server\n\n[![smithery badge](https://smithery.ai/badge/miraqo/seo)](https://smithery.ai/servers/miraqo/seo)\n\nConnect Claude, ChatGPT, Gemini, Claude Code or Cursor to your SEO data in\n[Miraqo](https://miraqo.io) — rankings, technical audit, backlinks, competitors,\nSearch Console and AI visibility — and query it in plain language from the chat\nyou already use.\n\nThis is a **hosted, remote MCP server**. There is nothing to install and nothing\nto run locally. This repository is documentation only.\n\n```\nhttps://app.miraqo.io/mcp\n```\n\nYou need a Miraqo account. A 14-day free trial is available, no card required.\n\n---\n\n## Setup\n\n### claude.ai, ChatGPT, Gemini — one click\n\nAdd a **custom connector** and paste the address above. A standard OAuth\nauthorization starts automatically: sign in to Miraqo, confirm, done. No token\nto generate or paste.\n\nWhere you add a connector differs slightly between apps (and may depend on your\nplan with that app), but the address is always the same.\n\nYou can revoke access at any time from **Account settings → AI Connector (MCP) →\nConnected apps**.\n\n### Claude Code\n\nGenerate a personal token in **Account settings → AI Connector (MCP)**, then:\n\n```bash\nclaude mcp add --transport http miraqo https://app.miraqo.io/mcp \\\n  --header \"Authorization: Bearer YOUR_TOKEN\"\n```\n\n### Cursor and other token-based clients\n\n```json\n{\n  \"mcpServers\": {\n    \"miraqo\": {\n      \"url\": \"https://app.miraqo.io/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_TOKEN\" }\n    }\n  }\n}\n```\n\nTokens are shown **once** at creation. You can keep up to 5 active and revoke\nthem individually.\n\n---\n\n## Tools\n\n26 tools. Start with `list_projects` to get the `project_id` the others take.\n\n### Read — never consume plan quota\n\n| Tool | What it returns |\n| --- | --- |\n| `list_projects` | Your projects, each with its latest audit (id, status, date, score) |\n| `get_usage` | Month-to-date consumption against plan limits, including the MCP action cap |\n| `get_keywords` | Tracked keywords with latest position, URL and AI Overview presence |\n| `get_keyword_history` | Up to 365 days of position history for one keyword, with SERP features |\n| `get_competitors` | Tracked competitors: average position and keyword-gap size |\n| `get_keyword_gap` | Keywords a competitor ranks for, with volume, difficulty and CPC |\n| `get_domain_analysis` | Cached competitive snapshot of any domain: authority, organic keywords, top pages |\n| `get_backlinks` | Latest backlink snapshot: new, lost, referring domains, anchors, spam score |\n| `get_audit_overview` | Score, pages crawled and what the latest audit produced |\n| `get_audit_issues` | Non-zero issue counters: 404s, titles, duplicates, security, sitemap |\n| `get_audit_pages` | Per-page status, title, word count, load/LCP/TTI and issue flags |\n| `get_audit_redirects` | Redirect chains with `linked_from` — the pages where the fix belongs |\n| `get_cwv_report` | Core Web Vitals: lab and field data, worst pages by LCP |\n| `get_topical_architecture` | Topic clusters with their pillar pages, structural or AI-refined |\n| `get_cluster_pages` | Pages in a cluster, ranked by inbound internal links |\n| `find_pages` | Search crawled pages by URL or title substring |\n| `get_ai_visibility` | Whether AI assistants mention your brand and cite your URLs, with share of voice |\n| `get_gsc_performance` | Search Console by query or page, aggregated over 7/28/90-day windows |\n| `get_gsc_daily` | Day-by-day Search Console site totals — the series to date a drop against |\n\n### Actions — consume plan quota\n\nEach also counts against a separate monthly cap on MCP-initiated actions. Check\n`get_usage` before running them.\n\n| Tool | What it does |\n| --- | --- |\n| `run_audit` | Starts a new technical crawl. Costs audit credits equal to the pages actually analysed |\n| `run_keyword_research` | Volume, difficulty and CPC — by seed, list, domain, or gap against a competitor |\n| `run_domain_analysis` | Refreshes a competitive snapshot. Reuses a snapshot newer than 7 days for free |\n| `run_ai_visibility_check` | Re-runs the project's AI visibility prompts |\n| `add_ai_prompt` | Creates an AI visibility prompt and runs the first check |\n| `refine_topical_architecture` | AI pass over the audit's topic clusters. Once per audit |\n| `generate_topical_bridge` | Writes a linking paragraph to connect two pages. Cached pairs are free |\n\nReads are unmetered, so exploring your data costs nothing.\n\n---\n\n## REST API\n\nThe same capabilities are available as a documented REST API under `/api/v1`,\nfor integrations that are not MCP clients. The link is in the AI Connector card\nin your account settings.\n\n## Notes\n\n- Tool descriptions are currently served in Italian. The Miraqo interface is\n  available in Italian, English, German, French and Spanish.\n- Data scope follows your account: the server only ever exposes projects the\n  authenticated token can already see, and respects per-user project permissions.\n\n## Links\n\n- [miraqo.io](https://miraqo.io)\n- [AI Connector guide](https://miraqo.io/help/connettore-ai-mcp/)\n- [Asking questions about your data](https://miraqo.io/help/chatta-con-i-tuoi-dati/)\n- [Pricing](https://miraqo.io/prezzi/)\n\nIssues and questions about the connector are welcome here. For account or\nbilling matters, write to supporto@miraqo.io.\n",
  "bytes": 5314,
  "sha": "2530db1900af4bcd3a8011cb7296ad824ba850a5de27b870e850651a1b074312",
  "repo_slug": "miraqo-io/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_deleteweb_seo_3e28b7cb/readme"
}