# Reverb MCP for AI Agents AI Agent Connect > Reverb MCP lets you manage your musical gear shop directly through your AI client. You can create listings, track shipping, check payouts, and talk to customers without leaving your workspace. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Tz9HFgJ8ZodjEvVdCh8HkAJoXzciLZa3jwzhIsbl/ai-agent-connect - **Tags:** marketplace, musical-instruments, order-fulfillment, seller-tools, inventory-tracking, payouts ## Description Reverb MCP lets you manage your musical gear marketplace operations through natural conversation. Managing a shop on Reverb usually means jumping between tabs, copy-pasting product specs, and constantly checking your inbox for buyer questions. This connector changes that by letting your AI client do the heavy lifting for you. Instead of digging through the Reverb dashboard to find a specific order or update a price, you just tell your agent what needs doing. You can draft new listings for your vintage gear, handle the back-and-forth with customers about shipping, and keep an eye on your payouts in one place. It's a way to keep your marketplace business moving while you stay focused on your music. You'll find this is one of the most efficient ways to stay on top of your shop's health when you're using the Vinkius catalog to power your workspace. It's about moving from manual data entry to just giving directions. You can handle everything from ending a listing that sold out to bumping your active items to get more eyes on your products. It's about getting the right information at the right time without the usual friction of a web-based admin panel. ## Tools ### add_to_sale Add specific items to a promotional sale. This helps you group products for special marketplace events. ### bump_listing Increase the visibility of a listing on the marketplace. This helps your gear appear higher in search results. ### create_listing Generate a new product listing for your gear using a JSON payload. This lets you put new items on the marketplace without manual form entry. ### delete_draft Remove a draft listing you no longer want to publish. This keeps your workspace clean of unfinished work. ### enable_vacation_mode Put your shop on hold when you're away. This prevents new orders from coming in while you are unavailable. ### end_listing Close an active listing so it's no longer for sale. Use this when an item is sold outside the platform or no longer available. ### find_listings Search your current listings by SKU or state. This makes it easy to locate specific items in your inventory. ### get_bump_info Check the details of a listing's bump status. Use this to see when your item was last pushed to the top. ### get_feedback_received See what customers have said about your shop. This helps you monitor your reputation on the marketplace. ### get_feedback_sent Review the feedback you've left for other sellers. Use this to keep track of your own interactions with the community. ### get_listing_images Identify the image IDs currently attached to a listing. This is helpful for managing specific media assets. ### get_order_payment View the payment details for a specific order. Use this to verify transaction amounts for your records. ### get_payment_methods See which payment options are available for your shop. This helps you understand how your customers can pay you. ### get_payout_line_items Break down the specific items included in a payout. Use this to reconcile your earnings with your sales records. ### get_vacation_status Check if your shop is currently active or on vacation. This lets you quickly see your shop's public status. ### list_conversations See all your active and past messages with buyers. Use this to manage your customer service queue in one view. ### list_drafts View all the listings you've started but haven't published yet. This helps you keep track of your pending inventory. ### list_payouts See your history of earnings and payouts. Use this to monitor your consistent income from the marketplace. ### mark_order_picked_up Update an order status to show it's been collected. This keeps your fulfillment status accurate for the buyer. ### publish_listing Make a draft listing live for customers to see. This moves your gear from your workspace to the public marketplace. ### remove_bump Take back a bump from a specific listing. Use this if you need to adjust your visibility strategy for an item. ### ship_order Mark an order as shipped to notify the buyer. This triggers the necessary updates for your customer's tracking. ### update_listing Edit the details of an existing product listing. Use this to change prices, descriptions, or conditions on the fly. ### view_seller_sales See a history of your completed sales. Use this to keep track of your past marketplace performance. ### delete_listing_image Remove a specific photo from a product page. This is useful for correcting errors in your visual gallery. ### disable_vacation_mode Turn off vacation mode to let customers buy from your shop again. Use this when you are ready to resume sales. ### leave_feedback Submit a review for a buyer after a transaction. This helps you build your seller profile and community presence. ### remove_from_sale Take an item out of a current sale promotion. This is useful for managing specific inventory during a sale. ### reply_to_conversation Send a message back to a buyer in an existing thread. This allows you to handle customer inquiries instantly. ### retrieve_orders Pull a list of your current selling orders. Use this to see what needs to be packed and shipped next. ## Prompt Examples **Prompt:** ``` Find my active listings with the SKU 'STRAT-1965'. ``` **Response:** ``` I'm searching your listings... I found one active listing for 'STRAT-1965': 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 gear listings Draft or publish new musical instruments for sale using your AI client. ### Track shipping orders Mark items as shipped or picked up to keep buyers informed. ### Check payout history View your earnings and see the specific items included in each payout. ### Reply to buyer messages Manage customer conversations and feedback from your chat interface. ### Manage shop status Toggle vacation mode and check your shop's current active status. ### Boost listing visibility Use bumps and sales to get more eyes on your gear. ### Manage shop sales Add or remove items from specific marketplace sales. ## Use Cases ### The Out of Office Problem A seller goes on vacation and needs to pause sales. They ask their agent to `enable_vacation_mode` so they don't have to worry about orders while away. ### The Bulk Update A shop manager needs to find all items with a specific SKU. They use `find_listings` and then `update_listing` to change the price on all of them at once. ### The Customer Query A buyer asks about shipping. The seller uses `list_conversations` to find the thread and `reply_to_conversation` to give an immediate answer. ### The Payout Audit A seller wants to know why a payout was lower than expected. They use `get_payout_line_items` to see the exact breakdown of every transaction. ## Benefits - Stop jumping between tabs by using `list_conversations` and `reply_to_conversation` to handle customer service in one place. - Keep your inventory fresh by using `update_listing` and `create_listing` to manage your gear without logging into the web portal. - Stay on top of your money with `list_payouts` and `get_payout_line_items` to see exactly what you've earned. - Speed up fulfillment by using `ship_order` and `mark_order_picked_up` to update your customers instantly. - Control your shop's availability with `enable_vacation_mode` and `get_vacation_status` to prevent sales when you're busy. - Boost your visibility by using `bump_listing` and `add_to_sale` to get more eyes on your items. ## How It Works The bottom line is you get a chat-based control center for your musical gear shop. 1. Subscribe to the Reverb MCP and get your Personal Access Token from your Reverb account settings. 2. Plug your token into your AI client configuration to link your shop. 3. Ask your agent to perform tasks like finding pending orders or drafting new gear listings. ## Frequently Asked Questions **Can I use the Reverb MCP to create new listings?** Yes, you can create new listings directly through your AI client. This allows you to input your gear details and have them published to the marketplace without manually navigating the website. **How do I manage my shop's vacation mode?** You can tell your AI client to enable or disable vacation mode instantly. This is perfect for when you need to take a break and want to ensure no new orders come in while you're away. **Can I see my payouts with this?** Yes, you can ask your agent to list your payouts. It will pull your history and can even break down the specific items included in each payout for easier bookkeeping. **How does this help with customer service?** It lets you list all your conversations and reply to buyers directly from your chat interface. You can handle inquiries about shipping or product details as quickly as you would send a text message. **Can I update my shipping status?** Yes, you can mark orders as shipped or picked up through your agent. This keeps your customers updated and ensures your shop's fulfillment status remains accurate. **Is there a way to find specific items?** You can search for listings by SKU or state. This makes it much faster to locate specific pieces of gear in your inventory when you need to make quick updates. **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.