mcp-scan

mcp-scan is a skill for Claude Code from rezearcher/x402-data-api. It costs 0 tokens per session (409 once invoked), scanned A, original, MIT.

A pre-connection scanner for MCP servers, which expose tools that AI agents can call. It checks their advertised descriptions, input schemas, and hidden Unicode characters for prompt injection and tool-poisoning signs without calling the tools.

In plain words
What is it for?
Use it when installing, adding, or trusting an MCP server, including remote, private, OAuth-protected, and local servers.
Why use it?
It helps decide whether a third-party server is safe to connect before an agent can use it. The result is a clear, review, or block verdict; a detailed report is paid.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: positional $N argument.

Part of the greyridge-mcp-scan plugin — 1 skill shipped together

Good fit Use it when installing, adding, or trusting an MCP server, including remote, private, OAuth-protected, and local servers.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/rezearcher/x402-data-api/mcp-scan
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add rezearcher/x402-data-api --skill mcp-scan
Clone the repo
git clone --depth 1 https://github.com/rezearcher/x402-data-api

Made for: Claude Code.

Or install greyridge-mcp-scan, the plugin that ships this one along with the rest of its 1 skill.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mcp-scan

README.md
[![agentmods](https://agentmods.dev/badge/skills/rezearcher/x402-data-api/mcp-scan/github.svg)](https://agentmods.dev/skills/rezearcher/x402-data-api/mcp-scan)
Your own site
<a href="https://agentmods.dev/skills/rezearcher/x402-data-api/mcp-scan"><img src="https://agentmods.dev/badge/skills/rezearcher/x402-data-api/mcp-scan/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for mcp-scan

Your own site · 80×15
<a href="https://agentmods.dev/skills/rezearcher/x402-data-api/mcp-scan"><img src="https://agentmods.dev/badge/skills/rezearcher/x402-data-api/mcp-scan.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 409 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.00409
Opus 5.5 $0.00000 $0.00164
Sonnet 5.5 $0.00000 $0.00082
Haiku 4.5 $0.00000 $0.00041

Measured 2d ago against content hash b0bcb0bee863, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

mcp-scan scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s "$B/scan/mcp/preview?url=https://HOST/mcp"
outreach/skillpkg/skills/mcp-scan/SKILL.md · 33 lines

What it actually says

mcp-scan — vet an MCP server before you connect an agent to it

Static analysis of a server's advertised tool metadata (descriptions, schemas, hidden unicode). It does not call the server's tools. Free preview returns tools scanned, issue counts by severity, risk score and verdict (clear / review / block).

Remote server (Streamable HTTP)

B=https://x402-data-api.sigrunner.workers.dev
curl -s "$B/scan/mcp/preview?url=https://HOST/mcp"

Private, OAuth-gated or stdio server

Paste its tools/list result; nothing needs to be reachable from outside:

curl -s -X POST "$B/scan/mcp/preview" -H 'content-type: application/json' \
  -d '{"tools":[ ...the "tools" array from tools/list... ]}'

Acting on the verdict

  • clear — proceed.
  • review — read the flagged tool descriptions before enabling the server.
  • block — do not connect; tell the user which tool and why.

The full itemized report with evidence and OWASP mapping is the paid route GET /scan/mcp ($0.05 USDC via x402 on Base). CLI: npx github:rezearcher/greyridge-x402-tools mcpscan <url> (exit code 2 = block). Methodology and measured limits: https://github.com/rezearcher/x402-data-api/blob/main/docs/STATUS.md

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 33 lines · 0 tokens per session scan A b0bcb0bee863

Subscribe to this mod's changes

mcp-scan is a skill published in the GitHub repository rezearcher/x402-data-api (0 stars, last pushed yesterday), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 409 tokens. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-20.

Related

Other skills, from other repositories

add-provider

Add a new storage or service provider to the core package. Use when implementing a new backend for StorageService (e.g., a new database) or a new service provider (e.g., a new LLM backend).

cyanheads/mcp-ts-core · 47 tokens

add-export

Add a new subpath export to the @cyanheads/mcp-ts-core package. Use when creating a new public API surface that consumers import from a dedicated subpath (e.g., @cyanheads/mcp-ts-core/newutil).

cyanheads/mcp-ts-core · 50 tokens

pantheon-staking

Stake creator coins into Pantheon vaults on Base and Robinhood Chain, view staking positions, and claim monthly rewards. Use when the user mentions Pantheon, pantheonvaults, staking a creator coin for yield, or checking/claiming Pantheon vault rewards.

BankrBot/skills · 59 tokens

delu-oracle

Full-cognition token analysis for Base EVM tokens via the deluagent oracle. Pass a CA or cashtag, get back a flat decision header (action, conviction, entry/stop/size, read) plus full cognition report. Tiered x402 pricing — 100M+ DELU free, 50M+ 50k DELU, public 250k DELU. Sequential calls only.

BankrBot/skills · 87 tokens

base-agent-treasury

Use when building or advising on treasury management for an AI agent on Base mainnet. Covers when to hold USDC, when to use GBLIN treasury-backed index, when to use Morpho or Aave lending, and how to choose based on treasury size and revenue pattern.

gblinproject/gblin-treasury-risk-regime · 62 tokens

gblin

Hold cbBTC, WETH and USDC on Base as one token. GBLIN is a collateral-backed basket vault that mints and redeems at net asset value, moves target weight toward USDC when a basket asset falls sharply, and can always be redeemed in kind. Free read endpoints, no API key, no signup. Transactions come back unsigned and are…

gblinproject/gblin-treasury-risk-regime · 150 tokens