API.SH MCP Server
OfficialAllows retrieval of Amazon product details and related data, such as price and rating, via API.SH endpoints.
Allows querying Google search results and returning them as clean JSON for use by AI assistants.
Allows retrieval of TikTok account videos and related metrics, such as view counts, via API.SH endpoints.
Allows looking up Zillow real estate listings and related data, such as price history.
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:
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.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.
Related MCP server: agentpay-gateway
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/mcpOn Windows, if your client cannot find npx, use "command": "cmd" and "args": ["/c", "npx", "-y", "@api.sh/mcp"].
Environment variables
Variable | Required | Default | What it does |
| yes | Your API.SH API key. Sent as | |
| no |
| The remote MCP endpoint. |
| no |
| How long to wait for one request, in milliseconds. |
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:
Tool | What it does |
| Search the catalog by site or data type. Returns routes, required parameters and credit price. |
| Full details of one endpoint: every parameter with examples, and its price. |
| Run an endpoint and return its JSON. This is the only tool that spends credits. |
| Credits, spending and your recent calls. |
| Spend limits and API keys. |
| Ask for a site that is not in the catalog yet. |
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 serverThe 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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
One MCP server for 180+ live web-data APIs returning clean JSON from sites that block scrapers.
One API for public web data across social, directories and real estate, as clean JSON.
The world's public data, one API. License-cleared public data sources for agents, via MCP and REST.
Remote MCP for 1,500+ APIs. Vault-managed credentials; OAuth or API key. Search, load, and execute.
Related MCP Servers
AlicenseCqualityBmaintenanceHosted MCP server for 3926 structured public web-data tools across 488 platform groups, returning clean JSON for search, maps, commerce, social, and finance.14500252 npm1MIT- AlicenseNot gradedqualityDmaintenanceProvides a single MCP endpoint for 90+ tools across 42 backend servers (search, legal, domain, etc.) with per-call credit billing and a single API key.1MIT

PrismCrawl MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables live search, maps, reviews, and app store data from Google, Bing, Amazon, Apple, Yelp, and Tripadvisor, returned as structured JSON for use with any MCP client.MIT- FlicenseNot gradedqualityAmaintenanceEnables MCP clients to scrape web pages, extract structured data, search, crawl sites, generate schemas, schedule monitors, and inspect credits/history through hosted or local integrations.-