Twosio

Created By

2s-io17 days ago

Pay-per-call AI agent APIs on Base via x402 — 39 endpoints spanning USPTO patents, US law, academic papers, OFAC sanctions screening, geocoding, weather, AI utilities, image rendering. No signup or API keys — each call settles instantly in USDC.

# x402

# usdc

Overview Content Tools Comments

Content

2s.io — pay-per-call APIs for agents

@2sio/mcp exposes 2s.io's 132 paid REST endpoints to any MCP host. Every call is paid per request from a USDC-funded wallet using the x402 protocol, settled on Base or Solana — no accounts, no API keys, no signup.

Why

Live data. Patent grants from yesterday, court opinions and roll-call votes from last week, FDA recalls and USGS earthquakes from a minute ago — post-training-cutoff and continuously refreshed.
Authoritative + citable. Every response carries the upstream source URL. USPTO, SEC EDGAR, Congress.gov, FEC, openFDA, NHTSA, DOL, NWS, NOAA, USGS, US Census, OFAC, CourtListener (Free Law Project), Federal Register, OurAirports, arXiv, PubMed, Semantic Scholar, Wikipedia, Wikidata.
Structured. Typed JSON, deterministic shape, no LLM layer between you and the data (except where that's the point — see agent primitives).
Cheap. $0.001 – $0.06 per call. Sub-cent for most lookups.

Install (Claude Desktop / Cursor / any MCP host)

{
  "mcpServers": {
    "twosio": {
      "command": "npx",
      "args": ["-y", "@2sio/mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

EVM_PRIVATE_KEY is an EVM private key funded with USDC on Base mainnet. A few cents covers hundreds of calls.

What's in the catalog

Agent primitives: persistent key-value memory (put/get/list/delete), agent-to-agent marketplace (register, discover, profile, review), knowledge-delta — "what changed in topic X since date Y" with LLM-backed source routing and synthesis
Law: case-search, case-verify, opinion, attorney + judge lookup, federal-register, sanctions-check (OFAC SDN)
Government: Congress bills, amendments, committees, hearings, members, nominations, treaties; House + Senate roll-call votes; bill summaries; FEC candidates, committees, contributions, expenditures; FDA drug/device/food/animal-vet events + recalls; OSHA inspections + accidents, MSHA; USAspending awards; EPA facilities; USGS water
Finance: SEC EDGAR company facts, filings, insider trades (Form 4), 13F holdings; US Treasury debt + operating cash
Vehicles (NHTSA): VIN decode, WMI decode, recalls, complaints, investigations, makes/models
Patents (USPTO ODP): search, detail, documents
Papers: unified arXiv + PubMed + Semantic Scholar; Wikipedia summary; Wikidata entities
Geo / Earth: geocode forward + reverse, weather/zip, airport lookup + near, climate stations, quakes, tides, sunrise, earth events + now-composite, POI/near, timezone
US data: Census ACS ZIP demographics, College Scorecard, hospital + medical-license + broker lookup, USAJOBS + BLS series, IRS nonprofit search, NYC property parcels, parks + recreation, fuel stations + solar resource
Crypto: gas oracle, multi-chain address validate (BTC, ETH, SOL, LTC, TRX, XRP, BCH)
URLs / DNS / internet: unfurl, clean-to-markdown, DNS lookup, RDAP whois, IP geolocation (single + 100-IP bulk), npm/PyPI registry lookups, Hacker News
AI utilities: summarize, translate, extract (URL → typed JSON per schema), describe-image (vision + OCR), screenshot, image compress
Misc: hash compute, barcode/QR generate, countdown GIF, phone normalize, chemistry compounds, space weather, dictionary + related words, World Bank indicators, FX rates, book search, food/nutrition

Full live catalog: https://2s.io/api/directory. OpenAPI spec: https://2s.io/api/openapi. LLM manifest: https://2s.io/llms.txt.

Source + SDKs

MCP server: npmjs.com/package/@2sio/mcp
TypeScript SDK: npmjs.com/package/@2sio/sdk
Python SDK: pypi.org/project/2sio (+ LangChain and LlamaIndex adapters)
Public mirror + examples: github.com/2s-io/sdk

License

MIT.

Server Config

{
  "mcpServers": {
    "twosio": {
      "command": "npx",
      "args": [
        "-y",
        "@2sio/mcp"
      ],
      "env": {
        "TWOSIO_X402_PRIVATE_KEY": "<your 0x... EVM key with USDC on Base>"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

Tavily Mcp

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

DeepChatYour AI Partner on Desktop

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

Amap Maps高德地图官方 MCP Server

Playwright McpPlaywright MCP server

Serper MCP ServerA Serper MCP Server

Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.