ToolSocket MCP server

Q: How do I add ToolSocket MCP to Claude Code?

Run `claude mcp add --env TOOLSOCKET_API_KEY= toolsocket -- npx -y toolsocket` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add ToolSocket MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ VerifiedCommit Oct 28, 2026

satashili/toolsocket · javascript · MIT

Provides AI agents access to over 660 data tools across social media, weather, finance, and more via a single API key.

Also known as satashili/toolsocket

stdio remote Workflow Automation Search & Web Data

Install GitHub ↗

Stars: 0
Tools: —
Downloads, 30 days: —
Latest version: 0.1.0
Last commit: Oct 28, 2026
License: MIT

What is ToolSocket MCP?

ToolSocket provides AI agents access to over 660 data tools across social media, weather, finance, and more via a single API key.

Summary generated from the project's README

About ToolSocket MCP server

ToolSocket provides AI agents with access to a massive catalog of over 660 data tools covering social media, finance, weather, and more. Instead of managing individual accounts for platforms like TikTok, X, or GitHub, developers use a single API key and a prepaid balance to execute calls. This remote MCP server operates via a REST API or a local stdio bridge for clients like Cline or Zed that require a local command execution.

To keep context windows small, the server exposes four specific meta-tools: discover_tools, inspect_tool, run_tool, and get_run. This architecture allows an agent to search for a tool, examine its JSON schema, and execute it without loading hundreds of definitions at once. Users can connect through Claude Desktop, ChatGPT, or Cursor using OAuth or a Bearer token. The system uses a pay-per-call model where social platform data typically costs $0.0015 per call, while open-data tools are free.

What you can do with it

1Search for specific data toolsAn AI agent can search the catalog using natural language to find tools for specific platforms or topics.
2Retrieve social media informationDevelopers can use the service to pull data from various social networks without needing separate platform accounts.

Written from the project's README. Every use case is checked against a quote from it.

How to install ToolSocket MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeClaude DesktopCodexGemini CLI

$ claude mcp add --env TOOLSOCKET_API_KEY=<YOUR_TOOLSOCKET_API_KEY> toolsocket -- npx -y toolsocket

~/.cursor/mcp.json

{
  "mcpServers": {
    "toolsocket": {
      "command": "npx",
      "args": [
        "-y",
        "toolsocket"
      ],
      "env": {
        "TOOLSOCKET_API_KEY": "<YOUR_TOOLSOCKET_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "toolsocket": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "toolsocket"
      ],
      "env": {
        "TOOLSOCKET_API_KEY": "<YOUR_TOOLSOCKET_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "toolsocket": {
      "command": "npx",
      "args": [
        "-y",
        "toolsocket"
      ],
      "env": {
        "TOOLSOCKET_API_KEY": "<YOUR_TOOLSOCKET_API_KEY>"
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.toolsocket]
command = "npx"
args = ["-y", "toolsocket"]

[mcp_servers.toolsocket.env]
TOOLSOCKET_API_KEY = "<YOUR_TOOLSOCKET_API_KEY>"

~/.gemini/settings.json

{
  "mcpServers": {
    "toolsocket": {
      "command": "npx",
      "args": [
        "-y",
        "toolsocket"
      ],
      "env": {
        "TOOLSOCKET_API_KEY": "<YOUR_TOOLSOCKET_API_KEY>"
      }
    }
  }
}

Set 2 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

TOOLSOCKET_API_KEYRequiredSecret
API key from https://toolsocket.top/console
TOOLSOCKET_URL

Name	Description
TOOLSOCKET_API_KEY	API key from https://toolsocket.top/console	RequiredSecret
TOOLSOCKET_URL	—

Automated checks

Ran Nov 14, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablesatashili/toolsocket is public and reachablegithub.com/satashili/toolsocket ↗Pass
Package names this repository as its sourcetoolsocket names satashili/toolsocket as sourcenpmjs.com/package/toolsocket ↗Pass
Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
Commit or release in the last yearLast commit or release 2026-10-28github.com/satashili/toolsocket ↗Pass
OpenSSF ScorecardNot checked
Package name not close to a popular packageNo popular package one edit away from toolsocketPass
No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
Destructive tools are labelledNot checked
Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass

README

View on GitHub

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

Client	How
Claude.ai / Claude Desktop	Settings → Connectors → Add custom connector → paste the URL → sign in → Allow
ChatGPT	Settings → Apps & Connectors → Developer mode → Create → paste the URL, auth OAuth
Claude Code	`claude mcp add --transport http toolsocket https://toolsocket.top/mcp`, then `/mcp` → Authenticate
Cursor / VS Code / Windsurf / Codex	copy-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
`balance`	Balance and today's spend
`mcp`	stdio ⇄ remote MCP bridge (see below)
`logout`	Forget 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:

Tool	Does
`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

Read full README

ToolSocket MCP questions

How do I add ToolSocket MCP to Claude Code?

Run claude mcp add --env TOOLSOCKET_API_KEY=<YOUR_TOOLSOCKET_API_KEY> toolsocket -- npx -y toolsocket in your terminal. Add --scope user to make it available in every project.

How do I add ToolSocket MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Do I need accounts for every platform like TikTok or Instagram?

No, you can use ToolSocket to access these platforms without needing individual accounts for each one.

How can I connect ToolSocket to Claude Desktop?

You can connect by going to Settings, selecting Connectors, clicking Add custom connector, pasting the URL, signing in, and clicking Allow.

What happens if a tool call fails or times out?

Upstream errors and timeouts are automatically refunded to your balance.

Facts

Nov 14, 2026

Stars: 0
Downloads, 30 days: —
Latest version: 0.1.0
Last commit: Oct 28, 2026
License: MIT
Transport: stdio, remote
Package: toolsocket

satashili ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/satashili/toolsocket.svg)](https://hostedmcp.org/servers/satashili/toolsocket/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

About ToolSocket MCP server

What you can do with it

1Search for specific data toolsAn AI agent can search the catalog using natural language to find tools for specific platforms or topics.
2Retrieve social media informationDevelopers can use the service to pull data from various social networks without needing separate platform accounts.

Written from the project's README. Every use case is checked against a quote from it.

{ "mcpServers": { "toolsocket": { "command": "npx", "args": [ "-y", "toolsocket" ], "env": { "TOOLSOCKET_API_KEY": "<YOUR_TOOLSOCKET_API_KEY>" } } } }

{ "servers": { "toolsocket": { "type": "stdio", "command": "npx", "args": [ "-y", "toolsocket" ], "env": { "TOOLSOCKET_API_KEY": "<YOUR_TOOLSOCKET_API_KEY>" } } } }

{ "mcpServers": { "toolsocket": { "command": "npx", "args": [ "-y", "toolsocket" ], "env": { "TOOLSOCKET_API_KEY": "<YOUR_TOOLSOCKET_API_KEY>" } } } }

Name

Description

TOOLSOCKET_API_KEY

API key from https://toolsocket.top/console

RequiredSecret

TOOLSOCKET_URL

—

Client

How

Claude.ai / Claude Desktop

Settings → Connectors → Add custom connector → paste the URL → sign in → Allow

ChatGPT

Settings → Apps & Connectors → Developer mode → Create → paste the URL, auth OAuth

Claude Code

claude mcp add --transport http toolsocket https://toolsocket.top/mcp, then /mcp → Authenticate

Cursor / VS Code / Windsurf / Codex

copy-paste configs at toolsocket.top/docs

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

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

balance

Balance and today's spend

mcp

stdio ⇄ remote MCP bridge (see below)

logout

Forget the saved key

Tool

Does

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

ToolSocket MCP questions

How do I add ToolSocket MCP to Claude Code?

Run claude mcp add --env TOOLSOCKET_API_KEY=<YOUR_TOOLSOCKET_API_KEY> toolsocket -- npx -y toolsocket in your terminal. Add --scope user to make it available in every project.

How do I add ToolSocket MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Do I need accounts for every platform like TikTok or Instagram?

No, you can use ToolSocket to access these platforms without needing individual accounts for each one.

How can I connect ToolSocket to Claude Desktop?

You can connect by going to Settings, selecting Connectors, clicking Add custom connector, pasting the URL, signing in, and clicking Allow.

What happens if a tool call fails or times out?

Upstream errors and timeouts are automatically refunded to your balance.

ToolSocket MCP server

What is ToolSocket MCP?

About ToolSocket MCP server

What you can do with it

How to install ToolSocket MCP

Install ToolSocket MCP in Claude Code

Install ToolSocket MCP in Cursor

Install ToolSocket MCP in VS Code

Install ToolSocket MCP in Claude Desktop

Install ToolSocket MCP in Codex

Install ToolSocket MCP in Gemini CLI

Configuration

Automated checks

README

ToolSocket

Connect your agent (no install needed)

CLI

stdio MCP bridge

The four MCP tools

Pricing

Development

License

ToolSocket MCP questions

ToolSocket MCP server

What is ToolSocket MCP?

About ToolSocket MCP server

What you can do with it

How to install ToolSocket MCP

Install ToolSocket MCP in Claude Code

Install ToolSocket MCP in Cursor

Install ToolSocket MCP in VS Code

Install ToolSocket MCP in Claude Desktop

Install ToolSocket MCP in Codex

Install ToolSocket MCP in Gemini CLI

Configuration

Automated checks

README

ToolSocket

Connect your agent (no install needed)

CLI

stdio MCP bridge

The four MCP tools

Pricing

Development

License

ToolSocket MCP questions