Summary
Reverb API for sellers of music gear: own listings with draft, update and publish, orders and shipping with tracking, buyer messages, offers, refund requests, payouts and shop data. Personal access token.
Guided setup
Connect Reverb to Gemini in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Reverb in the guided setup, then add your MCP URL to Gemini. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for Reverb
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Reverb, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Reverb + Gemini
Reverb API for sellers of music gear: own listings with draft, update and publish, orders and shipping with tracking, buyer messages, offers, refund requests, payouts and shop data. Personal access token.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
REVERB_TOKEN
Step 1 — Get credentials
Setting up takes about 3 minutes.
- Sign in at reverb.com, open your user menu and go to My Profile.
- Click the API & Integrations tab, then Generate New Token.
- Enter a name and tick the scopes:
public,read_listings,write_listings,read_orders,write_orders,read_messages,write_messages,read_offers,write_offers,read_payoutsandread_profile. A tool whose scope is missing is refused. - Copy the token into
REVERB_TOKEN. Personal access tokens do not expire.
Reverb asks every seller to have billing set up and at least one listing made by hand on reverb.com before using the API.
Where to start: reverb_list_orders_awaiting_shipment shows what has to be shipped. reverb_list_my_listings shows your live listings (state all adds drafts and ended ones); reverb_get_shop shows the shop and its shipping profiles.
Listings: create a draft with reverb_create_listing (category uuid from reverb_list_categories, condition uuid from reverb_list_listing_conditions, shipping profile id from reverb_get_shop), change it with reverb_update_listing, and put it on sale with reverb_publish_listing. reverb_list_my_drafts lists unpublished drafts and reverb_get_listing reads one listing. Find a listing by your SKU with reverb_list_my_listings and sku. Only the conditions Brand New, B-Stock and Mint with inventory can hold more than one unit; a used item is a single piece and cannot be relisted once sold. Setting inventory to 0 ends the listing. reverb_end_listing is installed switched off.
Orders: reverb_list_orders (all, filter by last change), reverb_list_orders_awaiting_shipment, reverb_get_order. Ship only when status is paid, with reverb_ship_order (provider from reverb_list_shipping_providers and the tracking number); local pickups are closed with reverb_mark_order_picked_up. Shipping labels are not bought through this connector.
Messages and offers: reverb_list_conversations, reverb_get_conversation and reverb_send_message handle buyer messages. reverb_list_offers and reverb_get_offer read offers on your listings; reverb_decline_offer turns one down. reverb_accept_offer and reverb_counter_offer are installed switched off, because both commit you to a price.
Refunds and payouts: reverb_list_refund_requests reads refund requests. reverb_respond_to_refund_request and reverb_create_refund_request are installed switched off: approving a refund credits the buyer and debits you at once. reverb_list_payouts and reverb_list_payout_line_items read what Reverb paid to your bank and the fees per order.
Formats: money is an object with amount (decimal string such as 95.00), amount_cents, currency and display; send amount and currency. Dates are ISO 8601 with an offset. Ids: orders use the order number, listings the numeric listing id, categories and conditions a uuid.
Paging and links: Reverb answers in HAL JSON. Lists carry _links.next and _links.prev; when next is missing you are on the last page. Use page and per_page to move. Each object also lists the actions open to it under _links.
Errors: 401 means the token is wrong or lacks the scope; 404 not found; 406 the action would break a rule of the current state; 412 a validation error with message and errors per field; 429 too many calls.
Rate limits: reads 2,000 per minute or 10,000 per 10 minutes; writes 600 per minute or 3,000 per 10 minutes. Avoid syncing the whole shop at once.
Sandbox: sandbox.reverb.com is a separate site with its own accounts and tokens; this connector calls the production API.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Gemini
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart
gemini. - Run
/mcpinside Gemini CLI (orgemini mcp listin your shell) —anythingmcpshould show as connected. - Start prompting — Gemini CLI can now call the
Reverbtools.
Available tools
| Tool | What it does |
|---|---|
reverb_list_my_listings | List your own listings with their id, title, make, model, sku, condition, price (amount and currency), inventory and _links (the listing… |
reverb_list_my_drafts | List your draft listings (created but not yet published) with the same fields as reverb_list_my_listings: id, title, make, model, sku… |
reverb_get_listing | Read one listing by id with the fields a listing is created from: title, make, model, finish, year, description, condition, categories… |
reverb_create_listing | Create a listing as a draft on your Reverb shop. It is not visible to buyers until reverb_publish_listing is called. Give at least a title… |
reverb_update_listing | Update one of your listings (draft or live): only the fields given change. Typical uses: price, inventory, description, photos, shipping… |
reverb_publish_listing | Publish a draft listing so buyers can see and buy it. The draft must be complete (make and model known, category, condition, price, photos… |
reverb_end_listing | End a live listing so it can no longer be bought. Reason not_sold simply takes it down. Reason reverb_sale says you found the buyer on… |
reverb_list_orders | List the orders you sold, all statuses: order_number, status (unpaid, payment_pending, pending_review, blocked, paid, shipped, picked_up… |
reverb_list_orders_awaiting_shipment | List paid orders that still have to be shipped, with the same fields as reverb_list_orders (order_number, title, quantity, buyer_name… |
reverb_get_order | Read one sold order by its order number: order_number, status (unpaid, payment_pending, pending_review, blocked, paid, shipped, picked_up… |
reverb_ship_order | Mark a paid order as shipped with the carrier and the tracking number. With send_notification true Reverb emails the buyer that the item is… |
reverb_mark_order_picked_up | Mark a local pickup order as picked up by the buyer (orders with shipping_method local). The order status becomes picked_up. Use it only… |
reverb_list_shipping_providers | List the shipping providers (carriers) Reverb accepts when an order is marked shipped. Use the provider name exactly as listed in… |
reverb_list_conversations | List your message conversations on Reverb, each with its id (needed to read or answer it) and _links. With unread_only true only… |
reverb_get_conversation | Read one conversation in detail, with its messages in chronological order (oldest first), so the whole exchange with the buyer can be… |
reverb_send_message | Reply in an existing conversation. The other party receives the message on Reverb at once and it cannot be taken back, so write it as the… |
reverb_list_offers | List the active offers (Reverb calls them negotiations) buyers made on your listings, each with its id for reverb_get_offer and the answer… |
reverb_get_offer | Read the details of one offer (negotiation) by id: the listing it is on, the prices offered so far and its current state, with _links to… |
reverb_decline_offer | Decline a buyer's offer on one of your listings. The negotiation ends without a sale and the decline cannot be taken back; no price is… |
reverb_accept_offer | Accept a buyer's offer. This is binding: you agree to sell the item at the offered price and shipping price, and the buyer can pay at once.… |
reverb_counter_offer | Answer a buyer's offer with a counter-offer: your price and, optionally, a shipping price. A counter-offer is binding if the buyer accepts… |
reverb_list_refund_requests | List refund requests on your sales, by default the active ones (pending_seller_response and conditionally_approved): id, state, amount… |
reverb_respond_to_refund_request | Answer a refund request: conditionally_approved (you will refund once the item is back; the request stays open), approved (refund now… |
reverb_create_refund_request | Start a refund on one of your sold orders as the seller, full or partial. It is created as conditionally approved; the money moves when the… |
reverb_list_payouts | List the payouts Reverb sent to your bank account: per payout total (amount and currency), created_at, updated_at and _links.line_items… |
reverb_list_payout_line_items | List the lines of one payout, one per order: order_id, sale_date, sale_price, payout_currency and the fees taken (selling_fee… |
reverb_get_shop | Read your shop: id, name, description and shipping_profiles[] (id and name), whose ids go into shipping_profile_id of a listing. Shipping… |
reverb_list_categories | List all Reverb categories as one flat list with their uuid and name. The uuid is what the categories of a listing take. A long list; some… |
reverb_list_listing_conditions | List the conditions your shop may use on listings (Non functioning, Poor, Fair, Good, Very Good, Excellent, Mint, B-Stock, Brand New): uuid… |
Example prompts
- "Which Reverb orders are awaiting shipment?"
- "Draft a listing for my 2019 Gibson Les Paul Standard in Excellent condition at 2,200 USD."
- "Which offers from buyers are open on my listings?"
- "Ship order 12345678 with UPS tracking 1Z999AA10123456784."
- "Show my payouts from the last month and their line items."
FAQ
Where do I get the token? On reverb.com: user menu, My Profile, API & Integrations, Generate New Token, with the listing, order, message, offer, payout and profile scopes. Personal access tokens do not expire. Reverb asks for billing and one listing made by hand before the API works.
What does it cover? Your own shop: listings from draft to publish, orders and shipping, buyer conversations, offers, refund requests, payouts and shop data. Searching the whole marketplace without a token is the Reverb Listings connector.
Which tools install switched off? reverb_end_listing, reverb_accept_offer, reverb_counter_offer, reverb_respond_to_refund_request and reverb_create_refund_request, because they sell, refund or end a listing. Switch them on on the connector page only if the AI should use them.
Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.
Next steps
Was this guide helpful?