# ToolSocket

> ToolSocket is a freemium MCP server for analytics and data. Pay-per-call data tools for agents: social platforms, weather, GitHub and more. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://toolsocket.top/docs
- **Repository:** https://github.com/satashili/toolsocket
- **MCP Registry name:** io.github.satashili/toolsocket
- **Categories:** analytics and data, web search and scraping
- **Listing updated:** 2026-11-14

## About

Rather than loading hundreds of tool definitions, ToolSocket gives the agent four meta-tools: search the catalogue, inspect a tool's schema, run it, and fetch the status of a run that is still going. Run waits up to 30 seconds before returning a run id. The catalogue covers social platforms such as TikTok, Douyin, Instagram, YouTube, X, Reddit, Weibo and Bilibili, plus weather, GitHub, Wikipedia, FX and crypto; the README counts 660+ tools while the docs page says 880+.

All calls draw on one prepaid balance, so you need no account on each platform. Social data costs mostly $0.0015 per call, open-data tools are free, each tool shows its price before running, upstream errors and timeouts are refunded, and daily or per-key spend limits can be set in the console. Discovery works in English or Chinese.

Connect through OAuth in Claude, ChatGPT, Cursor and others, or with an API key header. The repository holds an MIT-licensed zero-dependency CLI and a stdio bridge for clients that cannot use remote servers.

## Features

- **Four meta-tools:** Discover, inspect, run and get_run keep the agent's context small.
- **Pay per call:** One prepaid balance covers every tool; open-data tools are free.
- **Spend limits:** Set daily and per-key limits in the console.
- **Automatic refunds:** Upstream errors and timeouts are refunded.
- **Bilingual search:** Search the catalogue in English or Chinese.
- **CLI and stdio bridge:** MIT-licensed command line and local bridge.

## Good for

- Pull trending topics from Douyin or TikTok into an agent's research
- Check a weather forecast for a city from an assistant
- Look up GitHub or Wikipedia data without separate API keys
- Cap an agent's spending on third-party data

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://toolsocket.top/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "toolsocket": {
      "url": "https://toolsocket.top/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "toolsocket": {
      "serverUrl": "https://toolsocket.top/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "toolsocket": {
      "type": "http",
      "url": "https://toolsocket.top/mcp"
    }
  }
}
```

## Tools

- `discover_tools`: Ranked catalogue search with price and live health.
- `inspect_tool`: Show a tool's description, input schema and example.
- `run_tool`: Run a tool, waiting up to 30 seconds.
- `get_run`: Get the status and output of a run.

## FAQ

### How much does it cost?

Social-platform data is mostly $0.0015 per call and open-data tools are free; each tool shows its price first.

### Do I need accounts on each platform?

No; ToolSocket handles access and bills one balance.

### How do I authenticate?

OAuth (recommended) or an API key sent as a bearer header.

### What if a call fails upstream?

Upstream errors and timeouts are refunded automatically.

### Is ToolSocket free?

ToolSocket has a free plan, with paid plans for more usage or features.

### How do I add ToolSocket to Claude Code?

Run this command in your terminal: claude mcp add --transport http toolsocket https://toolsocket.top/mcp

### What are the best alternatives to ToolSocket?

The closest alternatives to ToolSocket are Scrapling MCP Server, Firecrawl MCP Server, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP and SearXNG Search.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/toolsocket
