Scan an MCP server before connecting (metered)
scan_mcp_serverCheck an MCP server BEFORE you connect to it. Asks the server to introduce itself and list its tools, then analyzes the text it hands an agent: tool names, descriptions, parameter schemas and server instructions. Catches tool poisoning (hidden directives that point the agent at private keys or at an agent config file), parameters whose real purpose is to carry secrets or your conversation out, standing orders about ANOTHER server's tools (cross-server shadowing), and invisible-unicode payloads. Returns a verdict with the exact tool and line as evidence, plus a hash of what was advertised, so a server that changes its tools later does not inherit the old verdict. Metered like scan_artifact: an X-API-Key with credits, or pay per call over x402 at POST https://lazaretto.dev/v1/scan with target type mcp_server ($0.03 USDC on Base, no signup).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "scan_mcp_server"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The server's https endpoint, e.g. https://example.com/mcp. Streamable HTTP and SSE replies are both read. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| risk | Yes | `unknown` appears only with verdict `error`: the scan did not finish, so no level is asserted. It is not a clear result. | |
| verdict | Yes | ||
| findings | No | ||
| confidence | Yes | ||
| disclaimer | No | ||
| scanned_at | No | ||
| attestation | No | Compact JWS over the verdict, verifiable offline against /.well-known/jwks.json. | |
| target_hash | No | SHA-256 over the advertised tool set, so you can tell whether it changed since the scan. | |
| risk_summary | No | ||
| rules_version | No | ||
| tool_fingerprint | No | Hashes of what the server tells an agent: one per tool and one over all of them. Keep `sha256` when you approve a server and compare it on a later scan; a different value means its tools changed since, and the keys of `tools` whose hash differs say which. `partial` means a cap cut the read. |