search_businesses

Pack: yelp · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search_businesses for the schema, then POST the same URL with its arguments for the data.

Search for local businesses and restaurants on Yelp by term and location. Returns matching businesses with star ratings, review counts, price, categories, address, and phone. Example: search_businesses({ term: “pizza”, location: “San Francisco, CA” }).

Parameters

NameTypeRequiredDescription
termstringnoSearch term, e.g. “coffee”, “pizza”, “plumber”. Optional.
locationstringnoLocation to search, e.g. “San Francisco, CA” or “New York”. Provide this OR latitude+longitude.
latitudenumbernoLatitude of the search center. Use with longitude instead of location.
longitudenumbernoLongitude of the search center. Use with latitude instead of location.
limitnumbernoNumber of results to return (default 20, max 50).
sort_bystringnoSort order: “best_match” (default), “rating”, “review_count”, or “distance”.
pricestringnoPrice filter as comma-separated levels 1-4, e.g. “1,2,3” for $ to $$$.
open_nowbooleannoIf true, only return businesses currently open.
_apiKeystringnoRequired — your own Yelp Fusion key. Pipeworx fronts no platform key for Yelp (Fusion plan is $229/mo, #2275 open); every call is refused with none.

Example call

Arguments

{
  "term": "pizza",
  "location": "San Francisco, CA"
}

curl

curl -X POST https://gateway.pipeworx.io/yelp/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_businesses","arguments":{"term":"pizza","location":"San Francisco, CA"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_businesses', {
  "term": "pizza",
  "location": "San Francisco, CA"
});

More examples

{
  "term": "coffee",
  "latitude": 37.7749,
  "longitude": -122.4194
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the yelp pack
{
  "mcpServers": {
    "yelp": {
      "url": "https://gateway.pipeworx.io/yelp/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build October 17, 2026