Miraqo

io.github.deletewebPublished by GitHub account deletewebv1.0.0Updated Oct 27, 2026

Query your SEO data in plain language: rankings, audits, backlinks, competitors and AI visibility.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server that lets an assistant query your Miraqo SEO data — rankings, audits, backlinks, competitors and AI visibility — in plain language.

What you can do
  • List projects and check month-to-date usage against plan limits
  • Read tracked keywords, position history, competitors and keyword gaps
  • Inspect backlink snapshots and cached competitive domain snapshots
  • Review technical audits: overview, issues, per-page data, redirects and Core Web Vitals
  • Explore topical architecture, cluster pages and crawled pages by URL or title
  • Check AI visibility, Search Console performance and daily trends
When to use it
Useful when you already work in Miraqo and want to ask about rankings, audits, backlinks or competitor gaps from Claude, ChatGPT, Gemini, Claude Code or Cursor instead of the web interface. Reads are unmetered, so exploratory questions are cheap.
Requirements
A remote hosted endpoint; nothing to install locally. Requires a Miraqo account (14-day free trial, no card required) and OAuth sign-in for claude.ai, ChatGPT and Gemini, or a personal bearer token generated in account settings for Claude Code and Cursor. Up to 5 active tokens.
Before you install
Action tools consume plan quota and count against a separate monthly cap on MCP-initiated actions; run_audit spends audit credits equal to pages analysed. Tokens are shown only once and grant access to your project data, so store them carefully and revoke unused ones. Tool descriptions are currently served in Italian.

Installation

In SourceWeft

  1. Open Miraqo in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.deleteweb%2Fseo/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "miraqo": {
      "type": "http",
      "url": "https://app.miraqo.io/mcp"
    }
  }
}

README

Miraqo MCP Server

[smithery badge]

Connect Claude, ChatGPT, Gemini, Claude Code or Cursor to your SEO data in Miraqo — rankings, technical audit, backlinks, competitors, Search Console and AI visibility — and query it in plain language from the chat you already use.

This is a hosted, remote MCP server. There is nothing to install and nothing to run locally. This repository is documentation only.

https://app.miraqo.io/mcp

You need a Miraqo account. A 14-day free trial is available, no card required.

Setup

claude.ai, ChatGPT, Gemini — one click

Add a custom connector and paste the address above. A standard OAuth authorization starts automatically: sign in to Miraqo, confirm, done. No token to generate or paste.

Where you add a connector differs slightly between apps (and may depend on your plan with that app), but the address is always the same.

You can revoke access at any time from Account settings → AI Connector (MCP) → Connected apps.

Claude Code

Generate a personal token in Account settings → AI Connector (MCP), then:

bash
claude mcp add --transport http miraqo https://app.miraqo.io/mcp \  --header "Authorization: Bearer YOUR_TOKEN"

Cursor and other token-based clients

json
{  "mcpServers": {    "miraqo": {      "url": "https://app.miraqo.io/mcp",      "headers": { "Authorization": "Bearer YOUR_TOKEN" }    }  }}

Tokens are shown once at creation. You can keep up to 5 active and revoke them individually.

Tools

26 tools. Start with list_projects to get the project_id the others take.

Read — never consume plan quota

ToolWhat it returns
list_projectsYour projects, each with its latest audit (id, status, date, score)
get_usageMonth-to-date consumption against plan limits, including the MCP action cap
get_keywordsTracked keywords with latest position, URL and AI Overview presence
get_keyword_historyUp to 365 days of position history for one keyword, with SERP features
get_competitorsTracked competitors: average position and keyword-gap size
get_keyword_gapKeywords a competitor ranks for, with volume, difficulty and CPC
get_domain_analysisCached competitive snapshot of any domain: authority, organic keywords, top pages
get_backlinksLatest backlink snapshot: new, lost, referring domains, anchors, spam score
get_audit_overviewScore, pages crawled and what the latest audit produced
get_audit_issuesNon-zero issue counters: 404s, titles, duplicates, security, sitemap
get_audit_pagesPer-page status, title, word count, load/LCP/TTI and issue flags
get_audit_redirectsRedirect chains with linked_from — the pages where the fix belongs
get_cwv_reportCore Web Vitals: lab and field data, worst pages by LCP
get_topical_architectureTopic clusters with their pillar pages, structural or AI-refined
get_cluster_pagesPages in a cluster, ranked by inbound internal links
find_pagesSearch crawled pages by URL or title substring
get_ai_visibilityWhether AI assistants mention your brand and cite your URLs, with share of voice
get_gsc_performanceSearch Console by query or page, aggregated over 7/28/90-day windows
get_gsc_dailyDay-by-day Search Console site totals — the series to date a drop against

Actions — consume plan quota

Each also counts against a separate monthly cap on MCP-initiated actions. Check get_usage before running them.

ToolWhat it does
run_auditStarts a new technical crawl. Costs audit credits equal to the pages actually analysed
run_keyword_researchVolume, difficulty and CPC — by seed, list, domain, or gap against a competitor
run_domain_analysisRefreshes a competitive snapshot. Reuses a snapshot newer than 7 days for free
run_ai_visibility_checkRe-runs the project's AI visibility prompts
add_ai_promptCreates an AI visibility prompt and runs the first check
refine_topical_architectureAI pass over the audit's topic clusters. Once per audit
generate_topical_bridgeWrites a linking paragraph to connect two pages. Cached pairs are free

Reads are unmetered, so exploring your data costs nothing.

REST API

The same capabilities are available as a documented REST API under /api/v1, for integrations that are not MCP clients. The link is in the AI Connector card in your account settings.

Notes

  • Tool descriptions are currently served in Italian. The Miraqo interface is available in Italian, English, German, French and Spanish.
  • Data scope follows your account: the server only ever exposes projects the authenticated token can already see, and respects per-user project permissions.

Links

Issues and questions about the connector are welcome here. For account or billing matters, write to [email protected].

Source: README.md at commit 0c0e6ab

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts