@Metricspot/ Server
FreeNot checkedExposes SEO and AI-readability audit tools to AI agents, enabling one-shot anonymous audits or full authenticated audits with PDF reports and organic traffic da
About
Exposes SEO and AI-readability audit tools to AI agents, enabling one-shot anonymous audits or full authenticated audits with PDF reports and organic traffic data.
README
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
Install @Metricspot/ Server in Claude Desktop, Claude Code & Cursor
unyly install metricspot-mcp-serverInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add metricspot-mcp-server -- npx -y @metricspot/mcp-serverFAQ
Is @Metricspot/ Server MCP free?
Yes, @Metricspot/ Server MCP is free — one-click install via Unyly at no cost.
Does @Metricspot/ Server need an API key?
No, @Metricspot/ Server runs without API keys or environment variables.
Is @Metricspot/ Server hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install @Metricspot/ Server in Claude Desktop, Claude Code or Cursor?
Open @Metricspot/ Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Fetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzCompare @Metricspot/ Server with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs
