@2sio/mcp
MCP server for 2s.io — gives any MCP-aware agent 575+ pay-per-call tools: more ground-truth data than any other x402 API, a full AI gateway (chat, image, multi-model consensus), and agent infrastructure (storage, locks, queues, schedules, watchers).
upto billing (new on 2s): AI endpoints also accept the x402 upto scheme — authorize the quoted max, get settled for your actual usage (a real on-chain example settled at 1/42nd of the quote). Exact-scheme calls work unchanged.
Model Context Protocol is the standard for AI agents to discover and use tools. This package runs a local MCP server that exposes every 2s.io endpoint as a callable tool. Plug it into Claude Desktop, AgentKit, Cline, Continue, or any other MCP host.
npx @2sio/mcp --signer 0x...
No accounts to create. The server signs for whichever chain you configured a key on — Base USDC (EIP-3009) or Solana SPL-USDC. Settles in ~2 seconds. Prices start at $0.0025/call. 2s is an open-ended experiment in maximally-comprehensive agent infrastructure — the toolset grows continually (575+ endpoints across 113+ groups and counting).
Hosted (connect by URL, no install)
Prefer not to run anything? Point any MCP host at the hosted server:
Streamable-HTTP transport; set header X-EVM-Private-Key: 0x… (an EVM key funded with USDC on Base) and the server signs + settles x402 per call. Security tradeoff: with the hosted server your private key transits 2s's infrastructure to sign — for keys that never leave your machine, run this package locally (above) or use the @2sio/sdk instead.
🔔 Watchers — push, not poll
Beyond read tools, 2s exposes watchers: the agent arms one and 2s POSTs a signed callback the moment something happens — a wallet moves, a stock crosses a price, a company reports earnings — so the agent never has to poll. Flat $0.05 to arm; signed + retried delivery with a status backstop. Tools: watchers.crypto-address-activity, watchers.stock-price, watchers.earnings (+ watchers.status / watchers.cancel).
What's exposed
A single MCP install gives the agent tools spanning, among others:
- Security — CVE lookup (NVD + CISA KEV + EPSS), email-security, HTTP security headers, password-exposure, RPKI, CT logs, IOC reputation, CWE / ATT&CK / CAPEC, exploit availability
- Patents & trademarks — USPTO patent search/detail/documents, trademark full-text search
- Legal & courts — federal & state case search and citation verification (CourtListener / Free Law Project)
- Financial filings & markets — SEC EDGAR filings, equities, FX, crypto, treasury rates
- Government & public records — Federal Register, Congress, FEC, BLS, US Census, nonprofits, licenses
- Science & medicine — arXiv / PubMed / Semantic Scholar papers, ICD-10, clinical trials, chemistry, nutrition
- Vehicles & aviation — NHTSA VIN decode & recalls, aircraft registry, flights, airports
- Energy, agriculture & maritime — energy prices & production, USDA agriculture, soil, vessel & port data
- Geospatial & weather — geocoding, NWS/NOAA forecasts, climate, earthquakes, tides, places, parks
- Business & property — company registries, GLEIF LEI, KYB, property records
- Web & data utilities — URL → markdown, screenshots, schema extraction, validators, EDI, hashing, barcodes, image description, AI summarization
- Agent primitives — memory, marketplace, knowledge-delta, batch settlement
- Control plane — wallet-scoped agent infrastructure: distributed locks/leases, durable message queues, scheduled cron callbacks, pub/sub topics with fan-out
- Storage — pay-per-call wallet-keyed persistence: key-value, documents, vector / full-text search, private blobs
- Watchers (push, not poll) — arm a signed callback for when a wallet moves, a stock crosses a price, or a company reports earnings
See the live catalog for everything currently shipped.
Try it free first
Pass --trial (or set TWOS_TRIAL=1) to make real calls without paying — one free call per endpoint per hour, no key required. Drop the flag and configure a key when you're ready to pay per call.
Claude Desktop setup
Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"2sio": {
"command": "npx",
"args": ["-y", "@2sio/mcp"],
"env": {
"EVM_PRIVATE_KEY": "0x...your_funded_base_mainnet_key..."
}
}
}
}
Restart Claude Desktop. The agent now has 575+ new tools — patent search, court-case lookup, SEC filings, VIN decode, ICD-10 lookup, sanctions screening, structured webpage extraction, secret/PII redaction, geocoding, weather, distributed locks/queues/schedules, wallet-keyed storage, multi-model consensus, ID crosswalks, and much more.
AgentKit / programmatic use
import { createTwoSioMcpServer } from '@2sio/mcp'
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
const server = createTwoSioMcpServer({
privateKey: process.env.EVM_PRIVATE_KEY as `0x${string}`,
maxPriceUsd: 0.05,
})
await server.connect(new StdioServerTransport())
Safety
- There is no default price cap (
maxPriceUsd defaults to Infinity) — set --max-price (or the maxPriceUsd option) to opt into a ceiling above which the server refuses to sign.
- All payments use EIP-3009 single-use authorizations with a 60-second deadline. No spending allowances are issued; even if the key is compromised at rest, the attacker can only spend what's in the wallet at the moment of signing — and only at advertised prices.
- The key is read from env / argv into memory only; it never appears in any outgoing 2s.io request.
Same set as @2sio/sdk. See https://2s.io/api/directory for the live catalog and https://2s.io/.well-known/x402 for the machine-readable manifest.
Links