@metricspot/mcp-server

MCP serverDev tools

This integration gives your AI six tools for running SEO and AI-readability audits on web pages. It performs 91 checks and scores the results across 11 modules, so you can see how a page performs for search engines and how easily AI systems can read it.

Use @metricspot/mcp-server in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add @metricspot/mcp-server and connect your AI. About a minute.

Claude ChatGPT Ahel Desktop

Also: Claude Code · Cursor · Codex

Then ask your AI: use @metricspot/mcp-server to run audit anonymous

Needs your own API account. Keys stay in your vault.

Details

Available today. Use it from your connected AI after setup.

After adding it, ask your AI to run an SEO or AI-readability audit on a page and walk through the scores it reports.

@metricspot/mcp-serverStart free

What your AI can do with it

Run SEO audits on web pages
Measure how easily AI systems can read a page
Apply 91 individual checks to find issues
Score results across 11 modules
Use six dedicated audit tools for different angles

Install @metricspot/mcp-server

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

Claude Code
claude mcp add --transport http --scope user metricspot-mcp-server 'https://mcp.metricspot.com/mcp'
Run it once in your project, then open /mcp to approve any sign-in the server asks for.
Claude Desktop
https://mcp.metricspot.com/mcp
Add a custom connector in Settings, paste this address, and approve the sign-in.
Cursor
cursor://anysphere.cursor-deeplink/mcp/install?name=metricspot-mcp-server&config=eyJ1cmwiOiJodHRwczovL21jcC5tZXRyaWNzcG90LmNvbS9tY3AifQ==
Open the link and Cursor adds the server at that address.
ChatGPT
https://mcp.metricspot.com/mcp
In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.
Codex
codex mcp add metricspot-mcp-server --url 'https://mcp.metricspot.com/mcp'
Run it once, then sign in with codex mcp login metricspot-mcp-server if the server asks for an account.

From the project's README

As published by metricspot/mcp-server in README.md.

Model Context Protocol server for MetricSpot. Exposes 6 SEO + AI-readability audit tools to AI agents (Claude, ChatGPT, Gemini, Perplexity, Cursor, Zed, OpenClaw, custom bots).

Hosted Streamable HTTP endpoint: https://mcp.metricspot.com/mcp
Local stdio binary: npx @metricspot/mcp-server
Agent guide: https://metricspot.com/AGENTS.md

Tools

Tool	Auth	Description
`run_audit_anonymous`	none	One-shot audit, 1/IP/24h, no Core Web Vitals
`run_audit`	Bearer key	Full audit with PSI, returns `audit_id`
`get_audit`	Bearer key	Fetch audit + findings by id
`list_audits`	Bearer key	List the user's recent audits (max 100)
`get_audit_pdf`	Bearer key	Signed URL for the branded PDF report
`get_organic_traffic`	Bearer key	28-day GA4 + GSC snapshot (if Google linked)

Local install (stdio)

Claude Code (~/.claude/mcp.json):

{
  "mcpServers": {
    "metricspot": {
      "command": "npx",
      "args": ["-y", "@metricspot/mcp-server"],
      "env": {
        "MCP_API_KEY": "ms_live_xxx"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json) and Zed use the same shape.

Omit MCP_API_KEY to only use run_audit_anonymous.

Hosted (Streamable HTTP)

POST https://mcp.metricspot.com/mcp
Authorization: Bearer ms_live_xxx
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Env vars

Var	Default	Purpose
`PORT`	`3000`	HTTP listen port
`APP_API_BASE_URL`	`https://app.metricspot.com`	MetricSpot app API base (the `dev`/`dev:stdio` scripts override it to `http://localhost:3000`)
`APP_PUBLIC_BASE_URL`	falls back to `APP_API_BASE_URL`	Used to build `report_url`
`MCP_INTERNAL_TOKEN`	—	Service-to-service secret forwarded as `X-MCP-Internal-Token`
`MCP_API_KEY`	—	(stdio only) User API key, sent as `Authorization: Bearer` to the HTTP layer

Develop

bun install
bun run typecheck
bun test
bun run dev          # Streamable HTTP on :3000
bun run dev:stdio    # stdio loop (send JSON-RPC on stdin)

Deploy

Multi-stage Dockerfile produces a Bun runtime image. Independent Dokku app on the same Hetzner droplet as app/ and web/.

License

MIT

Tools it offers (6)

What this server listed when Ahel dialed its public endpoint in Oct 2026, with no key and no account of yours. The names are the server’s own.

run_audit_anonymous
run_audit
get_audit
list_audits
get_audit_pdf
get_organic_traffic

Signals

Last commit: May 2026

Advanced

Delivery: seo-mcp MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
Item type: mcp-server
Key: com-metricspot-seo-mcp
Source: github.com/metricspot/mcp-server
Hosted endpoint: https://mcp.metricspot.com/mcp

github.com/metricspot/mcp-server

More in Dev tools

world-data-statistics
MCP server · adarsh4052
More in Dev tools draw.io
MCP server · jgraph
More in Dev tools airtreks-mcp
MCP server · airtreks
More in Dev tools 0nMCP
MCP server · 0nork
More in Dev tools sportwizzard
MCP server · adamruehle
More in Dev tools github-mcp-server
MCP server · github
More in Dev tools