reverb_search
Pack: reverb · Endpoint: https://gateway.pipeworx.io/reverb/mcp
Search live Reverb.com listings for musical gear — guitars, amps, pedals, synths, drums, pro audio. Returns asking prices with make, model, year, finish, condition grade and seller, filterable by category, price band, year range, condition, make and region. Prices are what sellers ARE ASKING, not what anything sold for: Reverb retired its public Price Guide, so no realized-sale data is available from this source.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Free-text query, e.g. “stratocaster”, “Tube Screamer TS9”, “Juno-106” |
make | string | no | Brand filter, e.g. “Fender”, “Gibson”, “Roland” |
model | string | no | Model filter, e.g. “Les Paul Standard” |
product_type | string | no | Root category slug, e.g. “electric-guitars”, “effects-and-pedals”, “amps”, “keyboards-and-synths”, “drums-and-percussion”. Call reverb_categories for the full list. |
category | string | no | Sub-category slug, e.g. “solid-body” — pairs with product_type |
condition | string | no | Condition slug: ${CONDITION_SLUGS} |
price_min | number | no | Minimum price, in the currency given by currency (default USD) |
price_max | number | no | Maximum price |
currency | string | no | ISO currency for the price filters and returned prices (default USD) |
year_min | string | no | Earliest build year, e.g. “1960” |
year_max | string | no | Latest build year, e.g. “1970” |
item_region | string | no | Where the item ships FROM, e.g. “US”, “GB”, “EUR_EU” |
ships_to | string | no | Country code the item must ship to, e.g. “US” |
handmade | boolean | no | Restrict to handmade/boutique listings |
sort | string | no | price | published_at (default: Reverb relevance) |
order | string | no | asc | desc |
page | number | no | 1-based page. Paging past total_pages still works — see total_pages_note. |
per_page | number | no | 1-50 (default 20) |
Example call
Arguments
{
"query": "stratocaster",
"make": "Fender",
"product_type": "electric-guitars",
"condition": "used",
"price_min": 1000,
"price_max": 5000,
"sort": "price",
"order": "asc",
"per_page": 5
}
curl
curl -X POST https://gateway.pipeworx.io/reverb/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reverb_search","arguments":{"query":"stratocaster","make":"Fender","product_type":"electric-guitars","condition":"used","price_min":1000,"price_max":5000,"sort":"price","order":"asc","per_page":5}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('reverb_search', {
"query": "stratocaster",
"make": "Fender",
"product_type": "electric-guitars",
"condition": "used",
"price_min": 1000,
"price_max": 5000,
"sort": "price",
"order": "asc",
"per_page": 5
});
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"reverb": {
"url": "https://gateway.pipeworx.io/reverb/mcp"
}
}
}
See Getting Started for client-specific install steps.