Connect your agent to ToolSocket把你的 Agent 接入 ToolSocket

ToolSocket is a remote MCP server: one endpoint, 880+ data tools (TikTok, Douyin, Instagram, YouTube, X, Reddit, Weibo, Bilibili, weather, GitHub, Wikipedia…). Your agent searches the catalog, inspects a tool, and runs it — paid per call from one prepaid balance.

ToolSocket 是一个远程 MCP 服务器:一个地址,880+ 个数据工具(抖音、TikTok、微博、B站、Instagram、YouTube、X、Reddit、天气、GitHub、维基百科……)。你的 Agent 自己搜索、查看、调用工具,按次从同一个预充值余额扣费。

https://toolsocket.top/mcp

Two ways to authenticate. OAuth (recommended): the client opens a ToolSocket sign-in page, you click Allow, done. API key: create one in the Console and send it as Authorization: Bearer ts_live_…. Both spend the same account balance. Free tools cost nothing; paid tools need a balance — top up in the Console.

两种认证方式。OAuth(推荐):客户端会打开 ToolSocket 登录页,点「允许」即可。API Key:在控制台创建,然后以 Authorization: Bearer ts_live_… 请求头发送。两种方式扣的是同一个账户余额。免费工具不花钱;付费工具需要余额,请在控制台充值。

Connect a client接入客户端

Claude.ai / Claude Desktop OAuth

  1. Open Settings → Connectors and click Add custom connector.
  2. Name: ToolSocket, URL: https://toolsocket.top/mcp → Add.
  3. Click Connect, sign in to ToolSocket (Google, GitHub or email) and click Allow.
  4. In a chat, enable the ToolSocket connector from the tools menu and ask, e.g. “What's trending on Douyin right now?”
  1. 打开 Settings(设置)→ Connectors(连接器),点 Add custom connector。
  2. 名称填 ToolSocket,URL 填 https://toolsocket.top/mcp,点 Add。
  3. 点 Connect,登录 ToolSocket(Google、GitHub 或邮箱),点 允许。
  4. 在对话的工具菜单里打开 ToolSocket,然后直接问,比如「抖音现在的热榜是什么?」

Custom connectors are available on Claude's paid plans; on Team/Enterprise an owner may need to add it for the organization first.

自定义连接器需要 Claude 付费套餐;Team / Enterprise 可能需要管理员先在组织里添加。

ChatGPT OAuth

  1. In Settings → Apps & Connectors → Advanced settings, turn on Developer mode.
  2. Back in Apps & Connectors, click Create. MCP server URL: https://toolsocket.top/mcp, Authentication: OAuth.
  3. Sign in to ToolSocket and click Allow. Then enable the connector in a chat.
  1. 在 Settings → Apps & Connectors → Advanced settings 中打开 Developer mode。
  2. 回到 Apps & Connectors,点 Create。MCP server URL 填 https://toolsocket.top/mcp,Authentication 选 OAuth。
  3. 登录 ToolSocket 并点 允许,然后在对话中启用该连接器。

Menu names in ChatGPT change often; look for “connectors” and “developer mode”.

ChatGPT 的菜单名称经常变化,找「connectors」和「developer mode」即可。

Claude Code OAuth API key

With OAuth — add the server, then run /mcp inside Claude Code and choose Authenticate:

用 OAuth:先添加服务器,然后在 Claude Code 里输入 /mcp,选择 Authenticate:

claude mcp add --transport http toolsocket https://toolsocket.top/mcp

Or with an API key from the Console:

或者使用控制台里的 API Key:

export TOOLSOCKET_API_KEY=ts_live_…
claude mcp add --transport http toolsocket https://toolsocket.top/mcp \
  --header "Authorization: Bearer $TOOLSOCKET_API_KEY"

Cursor OAuth API key

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project). Without headers, Cursor will offer to sign in with OAuth.

写入 ~/.cursor/mcp.json(或项目里的 .cursor/mcp.json)。不写 headers 时,Cursor 会提示用 OAuth 登录。

~/.cursor/mcp.json
{
  "mcpServers": {
    "toolsocket": {
      "url": "https://toolsocket.top/mcp",
      "headers": { "Authorization": "Bearer ts_live_…" }
    }
  }
}

VS Code (Copilot) OAuth API key

.vscode/mcp.json
{
  "servers": {
    "toolsocket": {
      "type": "http",
      "url": "https://toolsocket.top/mcp"
    }
  }
}

VS Code will prompt you to sign in. To use a key instead, add "headers": { "Authorization": "Bearer ts_live_…" }.

VS Code 会提示登录。如果想用 Key,加上 "headers": { "Authorization": "Bearer ts_live_…" }。

Windsurf API key

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "toolsocket": {
      "serverUrl": "https://toolsocket.top/mcp",
      "headers": { "Authorization": "Bearer ts_live_…" }
    }
  }
}

Codex API key

~/.codex/config.toml
[mcp_servers.toolsocket]
url = "https://toolsocket.top/mcp"
bearer_token_env_var = "TOOLSOCKET_API_KEY"

Then export TOOLSOCKET_API_KEY=ts_live_… in the shell that starts Codex.

然后在启动 Codex 的终端里 export TOOLSOCKET_API_KEY=ts_live_…。

Other clients (stdio only)其他客户端(只支持 stdio) API key

For clients that can only launch a local command (Cline, older Claude Desktop configs, Zed…), use the ToolSocket CLI as a bridge:

只能启动本地命令的客户端(Cline、旧版 Claude 桌面配置、Zed 等),可以用 ToolSocket CLI 做桥接:

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

For clients that can only launch a local command (Cline, Zed, older Claude Desktop configs…), use the generic mcp-remote bridge: npx -y mcp-remote https://toolsocket.top/mcp --header "Authorization: Bearer ts_live_…".

只能启动本地命令的客户端(Cline、Zed、旧版 Claude 桌面配置等),可以用通用的 mcp-remote 桥接:npx -y mcp-remote https://toolsocket.top/mcp --header "Authorization: Bearer ts_live_…"。

SKILL.md API key

Agents that read Markdown skills (Claude Code, Codex, OpenClaw…) can learn ToolSocket from one line. They call the REST API with curl; no install needed.

能读 Markdown Skill 的 Agent(Claude Code、Codex、OpenClaw 等)只要一句话就能学会用 ToolSocket,直接用 curl 调 REST API,无需安装。

set up https://toolsocket.top/SKILL.md

MCP toolsMCP 工具

ToolSocket exposes a handful of meta-tools instead of 880 separate ones, so your agent's context stays small. The workflow is discover → inspect → run. Each MCP connection gets a session id (Mcp-Session-Id), so one conversation's calls are grouped automatically.

ToolSocket 只暴露几个元工具,而不是把 880 个工具全部注册,Agent 的上下文因此保持精简。流程是 discover → inspect → run。每个 MCP 连接会自动分配一个会话 ID(Mcp-Session-Id),同一次对话里的调用会被归在一起。

ToolArguments参数What it does作用
discover_toolsquery, limit?Natural-language search (English or 中文). Returns ranked tools with price and health.自然语言搜索(中英文均可),返回按相关度排序的工具及价格、健康度。
inspect_tooltoolFull description, input JSON Schema, example input and hints.完整说明、输入 JSON Schema、示例输入和提示。
run_tooltool, input, tag?Runs the tool; waits up to 30 s, otherwise returns a run id. tag labels the run.调用工具,最多等 30 秒,否则返回 run id。tag 用来给这次调用打标签。
get_runrun_idStatus and output of a run.查询一次调用的状态与结果。
list_runsstatus?, tag?, tool?, session_id?, limit?, cursor?Your recent runs, newest first.列出最近的调用,按时间倒序,可按状态、标签、工具、会话筛选。
stop_runrun_idStop a run that is still running. Stopped runs are not charged.中止进行中的调用,中止的不收费。
get_balance—Balance and today's spend.余额和今日花费。
create_topup_linkamount_usd?A one-time Stripe payment link for the user (minimum $5). Without an amount, returns the limits.生成一次性 Stripe 付款链接交给用户(最低 $5);不传金额时返回充值限额。
send_feedbacktext, run_id?Tell the ToolSocket team what worked, what didn't, or what you couldn't find.向 ToolSocket 团队反馈:哪里好用、哪里出错、搜不到什么。

REST API

Base URL https://toolsocket.top. Free tools need no auth; paid tools need Authorization: Bearer ts_live_….

基础地址 https://toolsocket.top。免费工具无需认证;付费工具需要 Authorization: Bearer ts_live_…。

EndpointPurpose用途
GET /v1/discover?q=…Search tools搜索工具
GET /v1/inspect?tool=…Tool details and input schema工具详情与输入结构
POST /v1/runRun: {"tool", "input", "wait": seconds, "tag"?, "session"?}调用:{"tool", "input", "wait": 秒数, "tag"?, "session"?}
GET /v1/runs/:id?wait=20Poll a run轮询结果
GET /v1/runs?status=&tag=&tool=&session=Run history, newest first; page with cursor调用记录,按时间倒序;用 cursor 翻页
POST /v1/runs/:id/stopStop a running run (not charged)中止进行中的调用(不收费)
GET /v1/sessionNew session id; send it as X-Session-Id on one task's calls生成会话 ID,在同一任务的每次调用里用 X-Session-Id 带上
POST /v1/topupPayment link: {"amount": 5} → {"url", …}. GET returns limits付款链接:{"amount": 5} → {"url", …};GET 返回限额
POST /v1/feedbackFeedback: {"text", "run_id"?}反馈:{"text", "run_id"?}
GET /v1/toolsWhole catalog完整目录
GET /v1/meBalance (with key)余额(需 Key)
curl -s "https://toolsocket.top/v1/discover?q=douyin%20hot%20search"

curl -s -X POST https://toolsocket.top/v1/run \
  -H "Authorization: Bearer $TOOLSOCKET_API_KEY" \
  -H "content-type: application/json" \
  -d '{"tool":"openmeteo#forecast","input":{"city":"Tokyo","days":2},"wait":30}'

CLI

An open-source, zero-dependency command-line client (Node 18+). Good for scripts, and as a stdio MCP bridge.

开源、零依赖的命令行客户端(Node 18+)。适合写脚本,也可作为 stdio MCP 桥接。

npx -y toolsocket login              # paste your ts_live_ key once
npx -y toolsocket discover "tiktok user videos"
npx -y toolsocket inspect tiktok#app/v3/fetch_user_post_videos
npx -y toolsocket run openmeteo#forecast -i city=Tokyo -i days=2
npx -y toolsocket balance
npx -y toolsocket mcp                # stdio MCP bridge

Source: github.com/satashili/toolsocket · MIT.

源码:github.com/satashili/toolsocket · MIT 协议。

Pricing & limits价格与限制

Errors错误码

HTTPCodeMeaning含义
401AUTH_REQUIRED · invalid_tokenPaid tool or MCP without a valid key/token.调用付费工具或 MCP 时缺少有效的 Key 或令牌。
402INSUFFICIENT_BALANCEThe response's topup block suggests an amount. Ask the user, then create a link with POST /v1/topup, or top up in the Console.返回里的 topup 给出建议金额。先征得用户同意,再用 POST /v1/topup 生成付款链接,或到控制台充值。
402DAILY_LIMIT · KEY_LIMITA spend limit you set was reached.达到你设置的消费上限。
422INVALID_INPUTInput doesn't match the schema — call inspect.输入不符合结构,请先 inspect。
429RATE_LIMITEDSlow down; retry after the given seconds.请求太频繁,按提示的秒数后重试。

Questions? support@toolsocket.top · Privacy · Terms

有问题?support@toolsocket.top · 隐私政策 · 服务条款