ToolSocket

ToolSocket

面向 AI Agent 的 660 多种数据工具。一个 API 密钥。按调用付费。

TikTok · Douyin · Instagram · YouTube · X · Reddit · Weibo · Bilibili · Zhihu · Kuaishou · Threads · LinkedIn · GitHub · Wikipedia · 天气 · 外汇 · 加密货币……

ToolSocket 是一个远程 MCP 服务，也提供 REST API。你的 Agent 可以搜索目录、查看工具的架构并运行工具。每次调用都从同一笔预付余额中扣费。你无需在各个平台分别注册账号，也没有订阅费用。

此仓库是开源的 CLI 和 stdio MCP bridge。服务托管于 https://toolsocket.top。

---

连接你的 Agent（无需安装）

MCP 端点为：

https://toolsocket.top/mcp

客户端	操作方法
Claude.ai / Claude Desktop	Settings → Connectors → Add custom connector → 粘贴 URL → 登录 → Allow
ChatGPT	Settings → Apps & Connectors → Developer mode → Create → 粘贴 URL，身份验证选择 OAuth
Claude Code	claude mcp add --transport http toolsocket https://toolsocket.top/mcp，然后运行 /mcp → Authenticate
Cursor / VS Code / Windsurf / Codex	在 toolsocket.top/docs 复制粘贴配置

OAuth 客户端只需登录即可。支持设置请求头的客户端也可以使用 Console 中的 API 密钥：Authorization: Bearer ts_live_…。

CLI

npx -y toolsocket login                      # paste a ts_live_ key from toolsocket.top/console
npx -y toolsocket discover "douyin hot search"
npx -y toolsocket inspect openmeteo#forecast
npx -y toolsocket run openmeteo#forecast -i city=Tokyo -i days=2
npx -y toolsocket balance

也可以使用 npm i -g toolsocket 全局安装。

命令
login [--key …]	将 API 密钥保存到 ~/.config/toolsocket/config.json（权限模式为 600）
discover <query> [-n 10]	使用自然语言搜索，支持英语或中文
inspect <tool>	描述、输入架构和示例
run <tool> [-i k=v]…	运行工具。-i 支持 k=v、'{"json":true}' 或 @file.json
get <run_id>	获取仍在运行中的任务
balance	查看余额和今日支出
mcp	stdio ⇄ 远程 MCP bridge（见下文）
logout	删除已保存的密钥

任意命令都可以添加 --json，以获取机器可读的输出。退出代码：0 成功，1 出错，2 任务运行失败，3 余额不足。

环境变量：TOOLSOCKET_API_KEY 会覆盖已保存的密钥。TOOLSOCKET_URL 用于指定 CLI 连接的其他服务。

stdio MCP bridge

有些客户端只能启动本地命令（Cline、Zed、较旧的 Claude Desktop 配置）。对于这些客户端，请添加：

{
  "mcpServers": {
    "toolsocket": {
      "command": "npx",
      "args": ["-y", "toolsocket", "mcp"],
      "env": { "TOOLSOCKET_API_KEY": "ts_live_…" }
    }
  }
}

四个 MCP 工具

你的 Agent 看到的是四个元工具，而不是 660 个工具定义，因此占用的上下文空间很小：

工具	功能
discover_tools(query, limit?)	按相关性排序的搜索结果，包含价格和实时健康状态
inspect_tool(tool)	完整描述、输入 JSON Schema 和示例
run_tool(tool, input)	运行工具；最多等待 30 秒，否则返回任务 ID
get_run(run_id)	查看任务状态和输出

定价

• 社交平台数据的费用大多为每次调用 $0.0015。开放数据工具免费。
• 每个工具都会在运行前显示价格。
• 上游错误和超时会自动退款。
• 你可以在 Console 中设置每日和每密钥支出限额。

开发

CLI 没有任何依赖，且只有一个文件：bin/toolsocket.js。

node bin/toolsocket.js --help
TOOLSOCKET_URL=http://127.0.0.1:8091 node bin/toolsocket.js discover weather

许可证

MIT