English Français العربية

ToolSocket

Official registry Developer tools

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http toolsocket 'https://toolsocket.top/mcp'
JSON configuration (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 configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "toolsocket": {
            "command": "npx",
            "args": [
                "-y",
                "toolsocket@0.1.0",
                "mcp"
            ],
            "env": {
                "TOOLSOCKET_API_KEY": "<your toolsocket_api_key>"
            }
        }
    }
}

Environment variables

  • TOOLSOCKET_API_KEY required secret API key from https://toolsocket.top/console

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is ToolSocket?

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

How do I install ToolSocket?

It runs as a remote server. In Claude Code: claude mcp add --transport http toolsocket 'https://toolsocket.top/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ToolSocket need an API key?

Yes. It expects TOOLSOCKET_API_KEY, which you set in its configuration.

Is ToolSocket open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ToolSocket?

It is published by satashili. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.