by yelp
4 Yelp endpoints. Pay per call in USDC via x402.
The sh.fetcher.yelp/mcp server exposes 4 Yelp endpoints through a model context protocol (MCP) interface. Its description indicates a pay-per-call billing model denominated in USDC, using x402 for payments.
Captured live from the server via tools/list.
Free. Search fetcher.sh's Yelp endpoints by keyword. Returns paths, descriptions and per-call prices. Start here.
| query | string | optional | Keywords, e.g. 'twitter followers' or 'reviews' |
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Keywords, e.g. 'twitter followers' or 'reviews'"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Free. Show the full call signature for one endpoint: required and optional parameters, allowed values, price, and response shape.
| path | string | required | Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle} |
{
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}"
}
},
"required": [
"path"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Paid. Fetch live data from any Yelp endpoint. Pass the endpoint path plus its parameters (path and query parameters together in `params`). Priced per call in USDC on Base, Polygon, Arbitrum, 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.
| path | string | required | Endpoint path from search_endpoints, e.g. /api/yelp/search |
| params | object | optional | All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' } |
{
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Endpoint path from search_endpoints, e.g. /api/yelp/search"
},
"params": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
},
"description": "All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }"
}
},
"required": [
"path"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}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.
Parameters
No parameters.
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}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.
| amount | number | required | Amount to add, in USD. Minimum 1. |
| rotate | boolean | optional | Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent. |
{
"type": "object",
"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."
}
},
"required": [
"amount"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Paid ($0.003). Search — Yelp. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.
| page | string | optional | Optional. |
| query | string | required | Required. |
| location | string | required | Required. |
| sortBy | string | optional | Optional. One of: recommended, rating, reviewCount. |
{
"type": "object",
"properties": {
"page": {
"type": "string",
"description": "Optional."
},
"query": {
"type": "string",
"description": "Required."
},
"location": {
"type": "string",
"description": "Required."
},
"sortBy": {
"type": "string",
"enum": [
"recommended",
"rating",
"reviewCount"
],
"description": "Optional. One of: recommended, rating, reviewCount."
}
},
"required": [
"query",
"location"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Hosted server - connect over the network, no local install.
https://yelp.fetcher.sh/mcpclaude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://yelp.fetcher.sh/mcp"
]
}
}
}Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.