How do I install Sdk?

Sdk is a local plugin. Install it using npm package: @2sio/mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Sdk need?

Sdk requires the following credentials or environment variables: EVM_PRIVATE_KEY, TWOSIO_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Sdk?

Sdk uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Sdk MCP Server

by 2s Io

Developer ToolsModerate5.8MCP RegistryLocal

Free

Server data from the Official MCP Registry

MCP server for 2s.io — 40+ pay-per-call tools settled in USDC on Base via x402.

About

MCP server for 2s.io — 40+ pay-per-call tools settled in USDC on Base via x402.

Security Report

5.8

Moderate5.8Moderate Risk

This MCP server is a well-structured client for the 2s.io pay-per-call API platform. Authentication is properly handled via cryptographic signing (x402) or bearer tokens with appropriate safeguards including price limits and payment approval hooks. Code quality is good with proper error handling and no malicious patterns detected. Permissions are appropriate for a developer tool making HTTP API calls. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

6 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Hex-encoded EVM private key (0x-prefixed) used by the SDK to sign x402 EIP-3009 payment authorizations. Mutually exclusive with TWOSIO_API_KEY — provide one or the other. Funds USDC on Base.Required

Environment variable: EVM_PRIVATE_KEY

Bearer API key for pre-funded 2s.io account auth. Mutually exclusive with EVM_PRIVATE_KEY — use this if you want account-based debits instead of per-call x402 settlement.Required

Environment variable: TWOSIO_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-2s-io-mcp": {
      "env": {
        "TWOSIO_API_KEY": "your-twosio-api-key-here",
        "EVM_PRIVATE_KEY": "your-evm-private-key-here"
      },
      "args": [
        "-y",
        "@2sio/mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

2s.io SDK

Client SDK + MCP server for 2s.io — a unified JSON REST API for AI agents, paid per call in USDC on Base 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 viem`	✅ x402 + bearer
TypeScript / Node	`@2sio/mcp`	`npx @2sio/mcp`	✅ MCP server, x402 + bearer
Python	`2sio`	`pip install "2sio[x402]"`	✅ x402 + bearer
Go	`github.com/2s-io/sdk/packages/go`	`go get github.com/2s-io/sdk/packages/go`	🚧 bearer ready, x402 pending
Rust	`twosio`	`cargo add twosio`	🚧 bearer ready, x402 pending

No accounts. No API keys. No credit cards. Buyers sign an EIP-3009 USDC authorization on-the-fly, the Coinbase CDP facilitator verifies + settles in ~2 seconds on Base mainnet, and the API returns typed data. Prices start at $0.001/call.

30-second demo

TypeScript:

import { TwoS } from '@2sio/sdk'
import { privateKeyToAccount } from 'viem/accounts'

const client = new TwoS({ signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`) })

const { data } = await client.patents.search({ q: 'neural network', limit: 5 })
console.log(data.hits[0].title)

Python:

from eth_account import Account
from twosio import TwoS

client = TwoS(signer=Account.from_key(os.environ["EVM_PRIVATE_KEY"]))
r = client.patents.search(q="neural network", limit=5)
print(r.data["hits"][0]["title"])

30-second Claude Desktop install

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

Restart Claude. The model can now call patents.search, law.sanctions-check, ai.summarize, geocode.address, crypto.address-validate, and 30+ other paid tools — paying per call, no human in the loop.

What's behind the API

39 endpoints across:

AI: webpage summarization, translation, typed extraction, image description, screenshots
Patents: USPTO Open Data Portal search + full file-wrapper detail + document list
Law: federal/state case search, citation verification, OFAC sanctions screening, Federal Register, opinions
Geo / weather: forward + reverse geocoding, US weather by ZIP, NOAA tides, sunrise/sunset, climate stations, recent earthquakes, IP geolocation
Internet: DNS lookup, RDAP whois, URL unfurl (Open Graph), URL → clean Markdown
Wikipedia / academic papers: summaries, multi-source paper search (arXiv + PubMed + Semantic Scholar)
Crypto: multi-chain address validation (BTC, ETH, SOL, LTC, TRX, XRP, BCH), live EVM gas oracle
Airports: lookup by IATA/ICAO, nearest-airport-to-coord (OurAirports CC0, ~85k airports)
Utilities: hash computation, image compression, barcode/QR generation, countdown GIFs
Census: US Census ACS 5-year demographics by ZCTA
Account: balance + create (bearer mode)

Live catalog: https://2s.io/api/directory. OpenAPI 3.1: https://2s.io/api/openapi. Machine-discovery manifest: https://2s.io/.well-known/x402.

Safety

The SDK refuses to sign payments above a configurable maxPriceUsd (default $0.10).
Every x402 payment is a single-use EIP-3009 authorization with a 60-second deadline. No allowances are issued; a leaked key can only spend what's in the wallet at the moment of signing, only at advertised prices.
Optional onPaymentRequested hook lets callers approve/deny each call programmatically.

Repo layout

packages/
├── 2s-sdk/     @2sio/sdk — typed client
└── 2s-mcp/     @2sio/mcp — MCP server (depends on 2s-sdk)
examples/sdk/   minimal paying-agent samples + Claude Desktop wiring

License

MIT. See LICENSE.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Sdk MCP Server

About

Security Report

Findings (7)Action required

Permissions Required

What You'll Need

How to Install

Documentation

2s.io SDK

30-second demo

30-second Claude Desktop install

What's behind the API

Safety

Repo layout

License

Links

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent