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
| Name | Type | Required | Description |
|---|---|---|---|
term | string | no | Search term, e.g. “coffee”, “pizza”, “plumber”. Optional. |
location | string | no | Location to search, e.g. “San Francisco, CA” or “New York”. Provide this OR latitude+longitude. |
latitude | number | no | Latitude of the search center. Use with longitude instead of location. |
longitude | number | no | Longitude of the search center. Use with latitude instead of location. |
limit | number | no | Number of results to return (default 20, max 50). |
sort_by | string | no | Sort order: “best_match” (default), “rating”, “review_count”, or “distance”. |
price | string | no | Price filter as comma-separated levels 1-4, e.g. “1,2,3” for $ to $$$. |
open_now | boolean | no | If true, only return businesses currently open. |
_apiKey | string | no | Required — 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.