About scry-mcp
scry-mcp is a keyless bridge for agents researching Solana wallet intelligence through Scry. It offers free coverage and catalog queries, then provides the exact endpoint and price for paid evidence without holding keys or funds.
Key features
- 01Checks wallet coverage before purchase
- 02Lists paid Scry endpoints and prices
- 03Returns payment route and request details
- 04Uses read-only GET requests to a fixed host
- 05Leaves x402 settlement to the agent
Use cases
- 01Check Scry coverage before requesting a dossier
- 02Find the route and price for source-of-funds research
- 03Locate a Pump.fun wallet cohort screening endpoint
MCP support
Exposes three tools to MCP clients for coverage checks, catalog lookup, and paid-endpoint discovery. For paid evidence, it returns the x402 URL and price; the agent pays the Scry API directly using its own wallet.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
3Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | Solana wallet address, base58, 32-44 chars (e.g. 4BdKaxN8G6ka4GYtQQWk4G4dZRUTX2vQH9GcXdBREFUk) |
Details
From the project READMEscry-mcp
A keyless, custody-free MCP server that bridges AI agents to Scry — Solana wallet intelligence paid per request via x402.
It holds no private keys and never moves funds. Free discovery tools are proxied directly; for paid evidence it hands the agent the exact x402 endpoint URL and price, and the agent settles the USDC payment with its own wallet against the Scry HTTPS API.
Tools
| Tool | Cost | What it does |
|---|---|---|
scry_coverage_check | free | Is a Solana wallet inside Scry's indexed cohort before you pay? Returns coverage status, confidence band, indexed flag. |
scry_catalog | free | List the paid Scry x402 endpoints with prices and request objects. |
scry_paid_endpoint | free | Given a product id + wallet/mint, return the exact x402 URL, price, and how-to-pay. The agent then pays the Scry API directly. |
What agents can ask
Scry is most useful when an agent already knows the research object and needs a bounded evidence route rather than a generic score:
- Solana wallet forensics: resolve the full one-wallet evidence dossier with coverage, provenance, freshness, and caveats.
- Solana wallet source of funds: find the funding-lineage route and inspect upstream funders, hop depth, and freshness before payment.
- Pump.fun wallet cohort risk: select the cohort-screening route before spending on individual wallet dossiers.
Example prompts:
Check whether this Solana wallet is covered by Scry before I approve a paid dossier.
Find the Scry route for tracing who funded a Solana wallet. Show the exact price,
input object, and caveats, but do not pay.
Resolve the Scry Pump.fun wallet-cohort evidence route and explain what it is not for.
Install (Claude Desktop / Cursor / any MCP client)
{
"mcpServers": {
"scry": { "command": "npx", "args": ["-y", "scry-mcp"] }
}
}
Requires Node.js 22.23.4+, 24.22.1+, or 26.12.1+ within those supported major lines. No API keys, no account, no wallet configuration for the free tools. To actually pay for evidence, your agent needs its own x402 payment layer (for example an x402 client wallet); this bridge only tells it where and how much.
Security posture
- No custody, no secrets: the server never holds keys or funds; paid calls are settled by the agent's own wallet directly against the Scry HTTPS API.
- Strict input validation: wallet and mint arguments must be base58 (32-44 chars) and are URL-encoded; ambiguous product ids are rejected with a candidate list instead of silently resolving to the wrong (priced) endpoint.
- Read-only: all three tools are GET-only against one fixed host (scry.solanahub.de); there is no way to point this server at another host.
- Small and auditable: a single ~250-line file, one direct dependency
(the official
@modelcontextprotocol/sdk), no install scripts.
Why keyless
Scry's paid API is already hardened and settles x402 payments directly to its own receiver. This bridge deliberately does not re-implement that or custody funds — it exposes the free surfaces and brokers the paid ones, which keeps it zero-secret and safe to run anywhere.
Links
- Service manifest: https://scry.solanahub.de/x402/service.json
- Product catalog: https://scry.solanahub.de/x402/products.json
- Discovery: https://scry.solanahub.de/x402/discovery.json
- Human docs: https://solanahub.de/en/scry/agent-discovery/
- Runnable payment examples: https://github.com/pfeilisolana/scry-x402-examples
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.