Twosio

@2sio/mcp

适用于 2s.io 的 MCP 服务——为任何支持 MCP 的 Agent 提供 575+ 个按次付费的工具：比任何其他 x402 API 都更丰富的真实数据、完整的 AI 网关（聊天、图像、多模型共识）以及 Agent 基础设施（存储、锁、队列、计划任务、监视器）。

按用量结算（2s 新功能）：AI 端点也支持 x402 upto 方案——授权报价的最高金额，最终按你的实际用量结算（一个真实的链上示例最终仅结算了报价的 1/42）。使用精确金额方案的调用不受影响。

Model Context Protocol 是 AI Agent 发现和使用工具的标准。此软件包会运行一个本地 MCP 服务，将 2s.io 的所有端点公开为可调用的工具。将其接入 Claude Desktop、AgentKit、Cline、Continue 或任何其他 MCP 宿主。

npx @2sio/mcp --signer 0x...

无需创建账户。服务会使用你为所配置的链提供的密钥进行签名——Base USDC (EIP-3009) 或 Solana SPL-USDC。约 2 秒即可结算。每次调用的价格低至 $0.0025。2s 是一项开放式实验，旨在打造尽可能全面的 Agent 基础设施——工具集持续扩展（目前已有 113+ 个类别中的 575+ 个端点，且还在不断增加）。

托管服务（通过 URL 连接，无需安装）

不想运行任何东西？将任意 MCP 宿主指向托管服务：

https://2s.io/mcp

使用 Streamable-HTTP 传输；设置标头 X-EVM-Private-Key: 0x…（在 Base 上持有 USDC 的 EVM 密钥），服务会为每次调用签名并结算 x402。安全方面的取舍：使用托管服务时，你的私钥会经过 2s 的基础设施进行签名——若要让密钥始终留在本机，请在本地运行此软件包（见上文），或改用 @2sio/sdk。

🔔 监视器——推送，而非轮询

除读取工具外，2s 还提供监视器：Agent 启用监视器后，2s 会在事件发生的瞬间 POST 一个经过签名的回调——例如钱包发生转账、股票价格触及某个价位、公司发布财报——因此 Agent 无需轮询。启用费用统一为 $0.05；提供签名投递和重试，并通过状态接口兜底。工具：watchers.crypto-address-activity、watchers.stock-price、watchers.earnings（以及 watchers.status / watchers.cancel）。

暴露的功能

一次 MCP 安装即可为 Agent 提供多种工具，包括：

• 安全 — CVE 查询（NVD + CISA KEV + EPSS）、电子邮件安全、HTTP 安全标头、密码泄露、RPKI、CT 日志、IOC 信誉、CWE / ATT&CK / CAPEC、漏洞利用可用性
• 专利与商标 — USPTO 专利搜索 / 详情 / 文档、商标全文搜索
• 法律与法院 — 联邦和州案件搜索及引文验证（CourtListener / Free Law Project）
• 金融申报与市场 — SEC EDGAR 申报文件、股票、外汇、加密货币、国债利率
• 政府与公共记录 — Federal Register、Congress、FEC、BLS、US Census、非营利组织、许可证
• 科学与医学 — arXiv / PubMed / Semantic Scholar 论文、ICD-10、临床试验、化学、营养
• 车辆与航空 — NHTSA VIN 解码与召回、飞机注册、航班、机场
• 能源、农业与海事 — 能源价格与产量、USDA 农业、土壤、船舶与港口数据
• 地理空间与天气 — 地理编码、NWS/NOAA 预报、气候、地震、潮汐、地点、公园
• 商业与房地产 — 公司注册信息、GLEIF LEI、KYB、房地产记录
• 网络与数据实用工具 — URL → Markdown、屏幕截图、架构提取、验证器、EDI、哈希、条形码、图像描述、AI 摘要
• Agent 基础工具 — 记忆、市场、知识差异、批量结算
• 控制平面 — 钱包范围的 Agent 基础设施：分布式锁 / 租约、持久化消息队列、定时 cron 回调、支持扇出的发布 / 订阅主题
• 存储 — 按调用付费、以钱包密钥关联的持久化存储：键值、文档、向量 / 全文搜索、私有 blob
• 监视器（推送而非轮询） — 设置签名回调，以便在钱包发生转账、股票价格越过阈值或公司发布收益报告时收到通知

请参阅实时目录，查看目前已提供的全部内容。

先免费试用

传入 --trial（或设置 TWOS_TRIAL=1），即可免费进行真实调用——每个端点每小时可免费调用一次，无需密钥。准备好按调用付费时，移除该标志并配置密钥。

Claude Desktop 配置

将以下内容添加到 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..."
      }
    }
  }
}

重启 Claude Desktop。现在，Agent 将拥有 575 多个新工具——专利搜索、法院案件查询、SEC 申报文件、VIN 解码、ICD-10 查询、制裁筛查、结构化网页提取、机密信息 / PII 脱敏、地理编码、天气、分布式锁 / 队列 / 日程安排、以钱包密钥关联的存储、多模型共识、ID 对照，以及更多功能。

AgentKit / 编程方式调用

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())

安全性

• 默认没有价格上限（maxPriceUsd 默认为 Infinity）——设置 --max-price（或 maxPriceUsd 选项），以启用价格上限；超过上限时，服务将拒绝签名。
• 所有付款均使用有效期为 60 秒的一次性 EIP-3009 授权。不发放消费额度；即使密钥在静态存储时遭到泄露，攻击者也只能花费签名时钱包中的金额，且只能按标示价格消费。
• 密钥只会从环境变量 / 命令行参数读入内存，不会出现在任何发往 2s.io 的请求中。

暴露的工具

与 @2sio/sdk 相同。请访问 https://2s.io/api/directory 查看实时目录，并访问 https://2s.io/.well-known/x402 查看机器可读清单。

链接

• 网站：https://2s.io
• 源码：https://github.com/2s-io/sdk
• SDK：@2sio/sdk
• 许可证：MIT