convez.ai
PluginIntegração & APIsIntermediário
2s-io

2s.io SDK

2s-io/sdk

API unificada pay-per-call com dados verificados para agentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

SDK cliente e servidor MCP para 2s.io, uma API unificada que oferece dados de centenas de endpoints pagos por chamada em USDC (Base/Solana). Suporta TypeScript, Python, Go e Rust com autenticação via blockchain e modo trial gratuito.

Instalação

$npx convez-ai 2s-io/sdk

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
9
Forks
0
Acompanhando
1
Saúde
50%
Último commit
há 3 semanas
Versão
v1.82.0
Issues abertas
3
Contribuidores
1

Casos de uso

  • Integrar validação de dados (IBAN, e-mail, etc.) em agentes de IA
  • Buscar dados de múltiplas fontes (patentes, notícias, dados públicos) via uma única API
  • Monetizar chamadas de API com pagamento blockchain em tempo real

Veredito

SDK robusto para integrar 2s.io em agentes; excelente para quem precisa de dados verificados com modelo de pagamento blockchain. Bem documentado, multi-linguagem e com modo trial que viabiliza testes sem wallet.

README

A tradução para o português deste README ainda está na fila.

2s.io SDK

smithery badge 2s-io/sdk MCP server

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:

LanguagePackageInstallStatus
TypeScript / Node@2sio/sdknpm install @2sio/sdk✅ x402
TypeScript / Node@2sio/mcpnpx @2sio/mcp✅ MCP server, x402
Python2siopip install 2sio✅ x402
Python / LangChainlangchain-twosiopip install langchain-twosio✅ Tool adapters
Python / LlamaIndexllama-index-tools-twosiopip install llama-index-tools-twosio✅ Tool adapters
Gogithub.com/2s-io/sdk/packages/gogo get github.com/2s-io/sdk/packages/go🚧 x402 wire-up pending
Rusttwosiocargo 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.001/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:

import { TwoS } from '@2sio/sdk'
const trial = new TwoS({ trial: true })            // no key required
const { data } = await trial.validate.iban({ iban: 'GB82WEST12345698765432' })
console.log(data.items[0].valid)                    // real result; response meta.trial = { free: true, ... }
from twosio import TwoS
trial = TwoS(trial=True)                            # no key required
print(trial.validate.iban(iban="GB82WEST12345698765432").data["items"][0]["valid"])
curl "https://2s.io/api/validate/iban?iban=GB82WEST12345698765432&trial=1"
npx -y @2sio/mcp --trial      # MCP host with free trial calls; or set TWOS_TRIAL=1

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.

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.items[0].title) // normalized envelope: { ok, items, total, source, meta? }

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, vehicle.vin-decode, security.cve, agent.knowledge-delta, and 300+ other paid tools — paying per call, no human in the loop.

What's behind the API

300+ endpoints across 95 groups (live count in the directory), spanning:

  • AI: webpage summarization, translation, typed extraction, image description, screenshots, audio transcription, HTML/URL → markdown
  • 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, natural-language endpoint search
  • Patents & trademarks: USPTO Open Data Portal search + full file-wrapper detail + document list; trademark full-text search + status
  • Law: federal/state case search, citation verification, OFAC sanctions screening, Federal Register, CFR & USC, opinions, dockets
  • Government & public records: Congress bills/votes/members, FEC campaign finance, FDA drug/device/food events + recalls, FEMA disaster declarations + risk index, OSHA/MSHA, USAspending, EPA, lobbying & foreign-agent filings
  • Finance & treasury: SEC EDGAR company facts, filings, insider trades, 13F holdings; US Treasury debt + statements; stock quotes; FX & currency conversion; bank routing; tax
  • Vehicles & transport: VIN decode, recalls, complaints, fuel economy, NCAP safety (NHTSA); aircraft registry; live flights; airports; maritime vessels & USCG cases
  • Health & medical: ICD-10 + RxNorm + drug pricing, hospital quality, Medicare provider + open-payments, clinical trials, professional-license lookup, gene/protein/species, chemistry
  • Agriculture, soil & energy: NASS crop stats, USDM drought, SSURGO soil profiles + hardiness zones; electricity generation mix, utility & electricity rates
  • Security: CVE + CISA KEV + EPSS, email-security, HTTP headers, password-exposure (HIBP), RPKI, CT logs, IOC reputation, CWE / ATT&CK / CAPEC, exploit availability
  • Geo / weather / earth: forward + reverse geocoding, US weather, NOAA tides, sunrise/sunset, climate stations, earthquakes, timezones, places, parks, IP geolocation (single + bulk)
  • Internet & dev: DNS lookup, RDAP whois, TLS inspection, URL unfurl, URL → markdown, code & dev tools, unit/currency conversion, EDI/EDIFACT
  • Science & reference: Wikipedia + Wikidata, multi-source paper search (arXiv + PubMed + Semantic Scholar), space launches/satellites/exoplanets, books, music (MusicBrainz), country & ISO codes, news
  • Crypto: multi-chain address validation (BTC, ETH, SOL, LTC, TRX, XRP, BCH), live EVM gas oracle
  • Business & property: Secretary-of-State entity search, KYB-360 screening, property records, email/phone validation, domain intel
  • Census / education / jobs: ACS demographics, College Scorecard, USAJOBS + BLS, food/nutrition, IRS nonprofit search
  • Utilities: hash computation, image compression, barcode/QR generation, countdown GIFs

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 TypeScript client
├── 2s-mcp/             @2sio/mcp — MCP server (depends on 2s-sdk)
├── python/             2sio — Python client
├── python-langchain/   langchain-twosio — LangChain tool adapters
├── python-llamaindex/  llama-index-tools-twosio — LlamaIndex tool adapters
├── go/                 Go client (x402 wire-up pending)
└── rust/               Rust client (x402 wire-up pending)
examples/sdk/   minimal paying-agent samples + Claude Desktop wiring

License

MIT. See LICENSE.

Links

Ver o original no GitHub

Bom para

Relacionados