MCP Server

fetcher.sh — web data for agents

sh.fetcher/mcp
Data & Analytics Search & Research Public & reachable MCP 2025-11-25

What this MCP does

Searches and retrieves paid web-data endpoints covering social platforms, search engines, maps, news, app stores, and review services.

check_balance
Free. Show the remaining credit balance for the API key sent in this connection's Authorization header. Call this before a long run of paid requests.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
describe_endpoint
Free. Show the full call signature for one endpoint: required and optional parameters, allowed values, price, and response shape.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['path'], 'properties': {'path': {'type': 'string', 'description': 'Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}'}}, 'additionalProperties': False}
fetch_data
Paid. Fetch live data from any fetcher.sh endpoint. Pass the endpoint path plus its parameters (path and query parameters together in `params`). Priced per call in USDC on Base, Monad or Solana: pay with x402, or send an Authorization: Bearer bby_live_... header to spend prepaid credits. Call describe_endpoint first if unsure about parameters. For a named tool per endpoint, use [service].fetcher.sh/mcp.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['path'], 'properties': {'path': {'type': 'string', 'description': 'Endpoint path from search_endpoints, e.g. /api/twitter/search'}, 'params': {'type': 'object', 'description': "All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }", 'additionalProperties': {'type': ['string', 'number', 'boolean']}}}, 'additionalProperties': False}
search_endpoints
Free. Search fetcher.sh's web-data endpoints (Twitter/X, YouTube, TikTok, Instagram, Reddit, Google, Google Maps, Google News, Google Play, App Store, Yelp) by keyword and/or service. Returns paths, descriptions and per-call prices. Start here.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'query': {'type': 'string', 'description': "Keywords, e.g. 'twitter followers' or 'reviews'"}, 'service': {'type': 'string', 'description': "Restrict to one service slug, e.g. 'twitter'"}}, 'additionalProperties': False}
topup_credits
Paid (the amount you choose, minimum $1). Buy prepaid credits with x402 so later calls skip the per-call payment round trip. With an Authorization: Bearer bby_live_... header on this connection it recharges that key. Without one, the paying wallet becomes the account and a new API key is minted and returned once — store it as a secret, it cannot be recovered.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['amount'], 'properties': {'amount': {'type': 'number', 'minimum': 1, 'description': 'Amount to add, in USD. Minimum 1.'}, 'rotate': {'type': 'boolean', 'description': 'Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent.'}}, 'additionalProperties': False}
Added
topup_credits
Sept. 17, 2026, 12:55 p.m.
Added
check_balance
Sept. 17, 2026, 12:55 p.m.
Added
fetch_data
Sept. 17, 2026, 12:55 p.m.
Added
describe_endpoint
Sept. 17, 2026, 12:55 p.m.
Added
search_endpoints
Sept. 17, 2026, 12:55 p.m.