# Reverb MCP > Reverb MCP Server manages your entire online shop operations. Use AI to create listings, track incoming orders, mark shipments, and review payouts—all without touching the website. It handles listing creation (`create_listing`), order tracking (`retrieve_orders`), payments (`list_payouts`), and customer replies (`reply_to_conversation`) in one flow. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** marketplace, musical-instruments, order-fulfillment, seller-tools, inventory-tracking, payouts ## Description Yo, listen up. You run an online shop—you know the grind. Reverb MCP Server hooks your entire operation into your AI client so you don't have to touch the website. It handles everything from listing new gear to collecting payments and talking to buyers, all through natural conversation. We let your agent do the heavy lifting, keeping you outta the web browser and back on what matters. **Managing Your Inventory & Listings:** You can create a whole bunch of listings using `create_listing`, submitting structured data for brand-new gear without opening the site. If an existing listing needs some love, you've got `update_listing` to tweak prices or descriptions on active or drafted items. Need to get rid of old ideas? You can use `delete_draft` to permanently wipe those unused drafts. To keep your best sellers visible, your agent runs `bump_listing`, increasing visibility right on the marketplace feed. If you're running a sale, you can add selected listings using `add_to_sale` or take them out with `remove_from_sale`. You can also end an active listing with `end_listing`—it takes it off sale but keeps the record just in case. Want to find what gear you've already listed? Use `find_listings`, searching by SKU or checking if they’re currently active or drafts. Need to manage images on a specific piece, use `get_listing_images` to grab the IDs first, then run `delete_listing_image` to take out a bad photo. **Handling Orders and Shipping:** When orders roll in, your agent handles it. You can pull up all sales records using `retrieve_orders`. Once you've got the details, you use `get_order_payment` to see exactly what payment was linked to that specific order ID. When the buyer picks it up, run `mark_order_picked_up` to update the status. If it needs to ship out, `ship_order` updates the record and gives tracking confirmation right away. You can also get a big picture of your total performance metrics by checking `view_seller_sales`. Sometimes you gotta adjust visibility; if you mess up a bump or want to remove one, use `remove_bump` or `remove_listing_image`. **Dealing with Money and Payouts:** Understanding where the cash comes from is key. Your agent fetches all available payment options using `get_payment_methods`. To see a summary of your earnings over time, you use `list_payouts`. You don't just get a lump sum; you can break down that single payout record into individual chunks with `get_payout_line_items` to know exactly what contributed. This gives you total clarity on every dollar. **Customer Service & Feedback:** Talking to buyers shouldn't be a headache. You pull up all the message threads and conversation history using `list_conversations`, then use `reply_to_conversation` to send a direct reply without logging in. When you wanna leave feedback for someone, you run `leave_feedback`. If you gotta check what buyers are saying about your stuff, use `get_feedback_received`; if you want to see the history of feedback *you* sent out, it's `get_feedback_sent`. **Shop Status and Maintenance:** Need to take a quick break? You can activate shop vacation mode with `enable_vacation_mode` or turn it off when you’re back online using `disable_vacation_mode`. Before you do either, check the status first; run `get_vacation_status` to see if your shop is currently paused. Finally, if you want to view all those listings you saved but haven't published yet, use `list_drafts`, or if you just need a quick summary of your payouts, `list_payouts` gets that for ya. ## Tools ### add_to_sale Adds selected listings to a defined sale event. ### bump_listing Increases the visibility of an active listing on the marketplace feed. ### create_listing Creates and submits a brand-new Reverb listing using structured data. ### delete_draft Permanently removes an unused draft listing from your saved drafts. ### delete_listing_image Removes a specific image asset associated with a listing. ### disable_vacation_mode Turns off shop vacation mode, making your store visible and accepting orders again. ### enable_vacation_mode Activates shop vacation mode to temporarily pause receiving orders. ### end_listing Deactivates an active listing, taking it off sale but keeping the draft record. ### find_listings Searches your seller listings by SKU or current status (active/draft). ### get_bump_info Retrieves details about how many times a listing has been bumped. ### get_feedback_received Pulls all feedback that buyers have left for you. ### get_feedback_sent Retrieves a history of feedback you've given to other users. ### get_listing_images Finds the IDs needed for specific images attached to a listing. ### get_order_payment Retrieves payment details associated with a specific order ID. ### get_payment_methods Lists all payment methods that are eligible for your payouts. ### get_payout_line_items Breaks down a single payout record into individual contributing line items. ### get_vacation_status Checks if your shop is currently in vacation mode or fully active. ### leave_feedback Submits feedback for a buyer based on their transaction. ### list_conversations Retrieves all message threads and conversation history with buyers. ### list_drafts Displays a list of every listing you've saved but not yet published. ### list_payouts Gets a summary of all your recorded earnings payouts over time. ### mark_order_picked_up Changes an order's status to 'picked up', confirming receipt by the buyer. ### publish_listing Moves a draft listing into active, visible marketplace status. ### remove_bump Removes an automatic or manual bump from a specific listing. ### remove_from_sale Takes one or more listings out of a currently running sale event. ### reply_to_conversation Sends a direct reply message to a buyer in an ongoing chat thread. ### retrieve_orders Gets a list of all sales orders placed for your items. ### ship_order Updates an order's status to 'shipped', providing tracking confirmation. ### update_listing Changes details (price, description) on an already active or drafted listing. ### view_seller_sales Retrieves a summary view of your total sales performance metrics. ## Prompt Examples **Prompt:** ``` Find all my active listings with the SKU 'GUITAR-001'. ``` **Response:** ``` I'm searching your listings... I found one active listing for 'GUITAR-001': a 1965 Vintage Stratocaster priced at $4,500. Would you like to see the full details or images? ``` **Prompt:** ``` Check if my shop is currently in vacation mode. ``` **Response:** ``` Checking your shop status... Your shop is currently active and NOT in vacation mode. You can use `enable_vacation_mode` if you need to take a break. ``` **Prompt:** ``` List my recent payouts and their amounts. ``` **Response:** ``` Retrieving your payout history... I found 3 recent payouts: $120.50 on May 10th, $450.00 on May 12th, and $89.00 on May 15th. Do you want to see the line items for any of these? ``` ## Capabilities ### Create and modify listings Use the agent to create new listings, update existing ones, set items on sale, or delete drafts without manual web navigation. ### Process sales orders Retrieve order details and mark them as shipped or picked up directly from your workflow, updating the status for buyers. ### Review financial payouts Fetch payment methods and list detailed payout records to understand exactly where your sales money came from. ### Manage customer communication List conversations, reply to buyer messages using `reply_to_conversation`, and manage feedback you've received or sent. ### Control shop status Enable or disable your shop’s vacation mode or check its current operational status at any time. ## Use Cases ### The End-of-Day Sales Wrapup You just finished a busy day. Your agent runs `retrieve_orders`, pulling all sales that occurred since noon. You check the status, notice three items need shipping confirmation, so you run `ship_order` for those three IDs. Finally, you call `view_seller_sales` to get a quick report on total revenue. ### The Listing Refresh You have an item that hasn't sold in two weeks. You ask your agent to find the listing using `find_listings`. It finds the ID, and you tell it to call `bump_listing` on it and also use `update_listing` to slightly lower the price by 10%. ### The Buyer Complaint A buyer sends a complaint about shipping speed. You ask your agent to list conversations (`list_conversations`) to review the history and then use `reply_to_conversation` to send an apology, attaching tracking details you found via `get_order_payment`. ### The Financial Audit It's tax time. You need proof of last month's earnings. You call `list_payouts` to get the dates and totals, then you loop through them calling `get_payout_line_items` for a full picture. ## Benefits - You manage the entire lifecycle from listing to payout. Use `create_listing`, then later use `update_listing` if you need to change the price or description without navigating the web interface. - Fulfillment is fast. Instead of emailing shipping labels, your agent runs `retrieve_orders` and then hits `ship_order` instantly, updating tracking information for buyers. - Customer service gets better. You can list all conversations (`list_conversations`) and reply directly using `reply_to_conversation`, keeping the record clean without switching apps. - Financial review is simple. Call `list_payouts` to see total earnings, then use `get_payout_line_items` to break down exactly what those funds represent. - Status management takes seconds. Need a break? Use `enable_vacation_mode`. When you're ready, call `disable_vacation_mode`—no manual toggle needed. ## How It Works The bottom line is: you talk to your AI client like you're talking to an assistant, and it handles the complex API calls needed for Reverb. 1. Subscribe to the Reverb server and provide your personal access token. 2. Your AI client authenticates with the MCP Server, granting it API access to your shop data. 3. You ask your agent to perform a task (e.g., 'Find all my pending orders'), and the agent executes the necessary tool calls. ## Frequently Asked Questions **How do I check my shop status using get_vacation_status?** You simply ask the agent to call `get_vacation_status`. It tells you immediately if your store is active or paused, so you know whether to proceed with listing updates. **What's the difference between list_drafts and find_listings?** `list_drafts` shows every draft saved in your account. `find_listings` is more specific; it searches for active listings by SKU or current status, helping you locate a specific item faster. **Can I update an order's payment details? (get_order_payment)** No. `get_order_payment` only retrieves the payment information for an existing order so you can verify funds or transaction types. It doesn't let you change them. **How do I reply to a buyer's message? (reply_to_conversation)** You tell your agent the conversation ID and what you want to say. The tool uses `reply_to_conversation` to send the message directly from your workflow. **What data payload do I need when using `create_listing`?** You must provide a JSON object that strictly follows Reverb's listing schema. The tool requires core details like title, description text, pricing structure, and condition to successfully publish the item. **How do I see the detailed breakdown of my earnings using `get_payout_line_items`?** It shows a line-by-line accounting of your payout. Instead of just giving a total, this tool breaks down revenue from sales, platform fees, and any associated taxes for that specific payment period. **What's the difference between `get_feedback_received` and `get_feedback_sent`?** The function `get_feedback_received` pulls reviews customers left for your items. `get_feedback_sent`, however, lets you retrieve the feedback you previously left for other sellers. **If I use `update_listing` and encounter an error, how do I troubleshoot it?** The API response will include a specific status code or error message. Generally, errors relate to invalid SKUs, missing required fields, or conflicts with other active listings. **Can I see my unpublished listings or drafts?** Yes, you can use the `list_drafts` tool to retrieve all listings that are currently in draft state but not yet live on the marketplace. **How do I update the shipping status of a sold item?** Use the `ship_order` tool. You will need to provide the order ID and relevant shipping details to mark the transaction as fulfilled. **Is it possible to reply to buyer messages directly?** Absolutely. Use `list_conversations` to find the thread and `reply_to_conversation` to send your message back to the buyer.