English Français العربية

ToolSocket

السجل الرسمي أدوات المطورين

660+ data tools for agents: TikTok, Douyin, Instagram, YouTube, X, weather, GitHub. Pay per call.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http toolsocket 'https://toolsocket.top/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "toolsocket": {
            "type": "http",
            "url": "https://toolsocket.top/mcp"
        }
    }
}
NPM package toolsocket
Claude Code 
claude mcp add toolsocket -e 'TOOLSOCKET_API_KEY=<your toolsocket_api_key>' -- npx -y toolsocket@0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "toolsocket": {
            "command": "npx",
            "args": [
                "-y",
                "toolsocket@0.1.0",
                "mcp"
            ],
            "env": {
                "TOOLSOCKET_API_KEY": "<your toolsocket_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • TOOLSOCKET_API_KEY إلزامي سري API key from https://toolsocket.top/console

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. ToolSocket
  2. Connect your agent (no install needed)
  3. CLI
  4. stdio MCP bridge
  5. The four MCP tools
  6. Pricing
  7. Development
  8. License

ToolSocket

660+ data tools for AI agents. One API key. Pay per call.

TikTok · Douyin · Instagram · YouTube · X · Reddit · Weibo · Bilibili · Zhihu · Kuaishou · Threads · LinkedIn · GitHub · Wikipedia · weather · FX · crypto …

ToolSocket is a remote MCP server plus a REST API. Your agent searches the catalog, inspects a tool's schema, and runs it. Every call is paid from one prepaid balance. You don't need an account with each platform, and there's no subscription.

This repository is the open-source CLI and stdio MCP bridge. The server lives at https://toolsocket.top.

Connect your agent (no install needed)

The MCP endpoint is:

https://toolsocket.top/mcp
ClientHow
Claude.ai / Claude DesktopSettings → Connectors → Add custom connector → paste the URL → sign in → Allow
ChatGPTSettings → Apps & Connectors → Developer mode → Create → paste the URL, auth OAuth
Claude Codeclaude mcp add --transport http toolsocket https://toolsocket.top/mcp, then /mcp → Authenticate
Cursor / VS Code / Windsurf / Codexcopy-paste configs at toolsocket.top/docs

OAuth clients only need a sign-in. Clients that take headers can use an API key from the Console instead: 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

Or install it globally with npm i -g toolsocket.

Command
login [--key …]Save your API key to ~/.config/toolsocket/config.json (mode 600)
discover <query> [-n 10]Plain-language search, in English or 中文
inspect <tool>Description, input schema, example
run <tool> [-i k=v]…Run a tool. -i takes k=v, '{"json":true}' or @file.json
get <run_id>Fetch a run that is still in progress
balanceBalance and today's spend
mcpstdio ⇄ remote MCP bridge (see below)
logoutForget the saved key

Add --json to any command to get machine-readable output. Exit codes: 0 ok, 1 error, 2 the run failed, 3 balance too low.

Environment variables: TOOLSOCKET_API_KEY overrides the saved key. TOOLSOCKET_URL points the CLI at another server.

stdio MCP bridge

Some clients can only launch a local command (Cline, Zed, older Claude Desktop configs). For those, add:

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

The four MCP tools

Your agent sees four meta-tools, not 660 tool definitions, so its context stays small:

ToolDoes
discover_tools(query, limit?)Ranked search with price and live health
inspect_tool(tool)Full description, input JSON Schema, example
run_tool(tool, input)Runs the tool; waits up to 30 s, otherwise returns a run id
get_run(run_id)Status and output of a run

Pricing

  • Social-platform data costs mostly $0.0015 per call. Open-data tools are free.
  • Each tool shows its price before you run it.
  • Upstream errors and timeouts are refunded automatically.
  • You can set daily and per-key spend limits in the Console.

Development

The CLI has zero dependencies and is a single file: bin/toolsocket.js.

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

License

MIT

الأسئلة الشائعة

ما هو ToolSocket؟

660+ data tools for agents: TikTok, Douyin, Instagram, YouTube, X, weather, GitHub. Pay per call.

كيف أثبّت ToolSocket؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http toolsocket 'https://toolsocket.top/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ToolSocket إلى مفتاح API؟

نعم. يتطلب TOOLSOCKET_API_KEY، وتضبطها في إعداداته.

هل ToolSocket مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون ToolSocket؟

ينشره satashili. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.