2s-io/sdk

**Client SDK + MCP server for 2s.io — the (most) everything API. One pay-per-call API giving AI agents ground-truth data across hundreds of endpoints, paid per call in USDC on Base or Solana via x402.**
This repo ships SDKs for every major agent-development language plus an MCP server for any MCP-aware host:
| Language | Package | Install | Status |
|---|---|---|---|
| **TypeScript / Node** | @2sio/sdk | npm install @2sio/sdk | ✅ x402 |
| **TypeScript / Node** | @2sio/mcp | npx @2sio/mcp | ✅ MCP server, x402 |
| **Python** | 2sio | pip install 2sio | ✅ x402 |
| **Python / LangChain** | langchain-twosio | pip install langchain-twosio | ✅ Tool adapters |
| **Python / LlamaIndex** | llama-index-tools-twosio | pip install llama-index-tools-twosio | ✅ Tool adapters |
| **Go** | github.com/2s-io/sdk/packages/go | go get github.com/2s-io/sdk/packages/go | 🚧 x402 wire-up pending |
| **Rust** | twosio | cargo add twosio | 🚧 x402 wire-up pending |
No accounts. No API keys. No credit cards. Buyers sign an EIP-3009 USDC authorization (Base) or an SPL USDC transfer (Solana) on-the-fly, the facilitator verifies + settles in ~2 seconds on mainnet, and the API returns typed data. Prices start at $0.0025/call.
🎁 Try before you buy — free, no wallet
Want to confirm an endpoint actually works before funding anything? Every endpoint serves **one free real call per endpoint per hour** — no key, no wallet, no signup. Add ?trial=1 (or header X-2s-Trial: 1), or flip the SDK into trial mode:
The trial runs the **real handler** and returns real data. Once the hourly trial is used, the endpoint returns the normal 402 — drop trial and pass a privateKey/signer to pay per call for unlimited access.
🔔 Watchers — get woken up, don't poll
Most endpoints are reads. **Watchers** flip that: arm one once and 2s pushes you a **signed callback the instant something happens** — a wallet moves on Base/Ethereum/Bitcoin, a US stock crosses your price, a company reports earnings. No polling loop, no wasted calls. Flat **$0.05** to arm; callbacks are EIP-191-signed (verify offline), retried with exponential backoff, with a pull backstop via watchers.status. A new class of stateful, agent-native primitives.
Hosted MCP (connect by URL)
Don't want to install anything? Point any MCP host at the hosted server:
Streamable-HTTP; set header X-EVM-Private-Key: 0x… (USDC on Base) and 2s signs + settles x402 per call. **Tradeoff: a hosted signer means your private key transits 2s's infrastructure — for keys that never leave your machine, run npx @2sio/mcp locally or use the SDK above (the more private, secure path).**
30-second demo
**TypeScript:**
**Python:**
30-second Claude Desktop install
Restart Claude. The model can now call patents.search, law.sanctions-check, ai.summarize, geocode.address, vehicle.vin-decode, agent.knowledge-delta, security.cve, and 340+ other paid tools — paying per call, no human in the loop.
What's behind the API
575+ endpoints across 113+ groups (live count in the directory) across:
- **AI:** webpage summarization, translation, typed extraction, image description, transcription, screenshots
- **Agent primitives:** persistent key-value memory, agent-to-agent marketplace (register / discover / review), knowledge-delta ("what changed in X since date Y"), atomic batch settlement