API.SH

API.SH MCP server

API.SH turns public web pages from around 1,000 websites into clean JSON: search engines, social media, e-commerce, real estate, jobs, travel, news and sports (Google, Amazon, TikTok, Zillow, LinkedIn and more). This MCP server lets an AI assistant find the right endpoint, read its parameters and call it for you.

There are two ways to connect:

1. Remote (recommended). Point your client at https://mcp.api.sh/mcp. Nothing to install. Sign in with OAuth, or send your API key as a Bearer token.
2. Local. Run npx -y @api.sh/mcp, the package in this repository. Use it when your client only runs local (stdio) MCP servers.

The local server is a thin bridge: it forwards every request to https://mcp.api.sh/mcp with your key. You get exactly the same tools, descriptions and results as the remote server, and new tools appear without an update.

Get an API key

Sign up and copy a key from the dashboard. Every account gets free monthly credits, and failed calls are free.

Option 1: remote server

Claude Desktop and claude.ai: Settings → Connectors → Add custom connector. Enter https://mcp.api.sh/mcp and sign in.

Claude Code:

claude mcp add --transport http apish https://mcp.api.sh/mcp

or with a key instead of OAuth:

claude mcp add --transport http apish https://mcp.api.sh/mcp --header "Authorization: Bearer your-api-key"

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

{

"mcpServers": { "apish": { "url": "https://mcp.api.sh/mcp" } } }

VS Code (.vscode/mcp.json):

{

"servers": { "apish": { "type": "http", "url": "https://mcp.api.sh/mcp" } } }

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

{

"mcpServers": { "apish": { "serverUrl": "https://mcp.api.sh/mcp" } } }

To skip OAuth in any client that supports headers, add "headers": { "Authorization": "Bearer your-api-key" } next to the URL.

Option 2: local server (npx)

Needs Node.js 20 or newer. Every client uses the same command, npx -y @api.sh/mcp, with your key in APISH_API_KEY.

Claude Desktop (claude_desktop_config.json, open it from Settings → Developer → Edit Config):

{

"mcpServers": { "apish": { "command": "npx", "args": ["-y", "@api.sh/mcp"], "env": { "APISH_API_KEY": "your-api-key" } } } }

Cursor (~/.cursor/mcp.json) and Windsurf (~/.codeium/windsurf/mcp_config.json) use the same mcpServers block as Claude Desktop above.

VS Code (.vscode/mcp.json). VS Code asks for the key once and stores it securely:

{

"inputs": [ { "type": "promptString", "id": "apish-key", "description": "API.SH API key", "password": true } ], "servers": { "apish": { "type": "stdio", "command": "npx", "args": ["-y", "@api.sh/mcp"], "env": { "APISH_API_KEY": "${input:apish-key}" } } } }

Claude Code:

claude mcp add apish --env APISH_API_KEY=your-api-key -- npx -y @api.sh/mcp

On Windows, if your client cannot find npx, use "command": "cmd" and "args": ["/c", "npx", "-y", "@api.sh/mcp"].

Environment variables

The server writes status and errors to stderr. If the key is missing or rejected, it exits with a clear message that your client shows in its MCP log.

Tools

The tools come from the hosted server, so this list may grow. The main ones:

Example prompts

• "Find the API.SH endpoint for Amazon product details, then get the price and rating for this product: "
• "Get the top Google results for 'best espresso machine' in the US and summarise what the first five pages recommend."
• "Pull the last 20 videos from the TikTok account @nasa and tell me which got the most views."
• "Look up this Zillow listing and show its price history: "
• "How many credits do I have left, and what did I spend them on this week?"

Use it from code

The package also exports the bridge, if you want to embed it:

import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

import { connectRemote, createBridge } from "@api.sh/mcp";

const remote = await connectRemote({ apiKey: process.env.APISH_API_KEY }); await createBridge(remote).connect(new StdioServerTransport());

Development

npm ci

npm test # build and run the offline tests APISH_API_KEY=your-api-key npm run test:live # one free search through the real server

The live test lists the tools and makes one search_apis call, which spends no credits.

Links

• MCP setup guide: https://api.sh/mcp?utm_source=github&utm_medium=readme
• API docs: https://api.sh/docs?utm_source=github&utm_medium=readme
• Live catalog (free, no key): https://api.api.sh/catalog
• Status: https://status.api.sh/?utm_source=github&utm_medium=readme
• Support: support@api.sh

License

MIT