MCP server
Your shops
Address
https://mcp.resell.store/u/your-private-linkEach tool lists the permission it needs. Tools your link isn't allowed to use don't show up in your app at all. See What it may do.
Overview
whats_waitingWhat needs mereadEverything waiting on the seller right now: offers to answer, sales to ship, unread buyer messages. Call this first.
whoamiWho am IreadThe account this connection belongs to, its shops and what this connection is allowed to do.
get_statsShop statsreadHow the shops are doing: earnings, things sold, views, likes, shares, followers, offers, where visitors came from and the most viewed listings, compared with the period before.
period?shop?
Shops
list_shopsList shopsreadThe seller's shops with their settings and listing counts.
get_shopGet a shopreadOne shop's settings and this week's numbers.
shop
update_shopChange shop settingsshopscan ask firstChange a shop's name, about, location, who can see it, whether it's paused, and what its agent may do (answer questions, haggle, lowest % off).
shopname?about?location?visibility?paused?answer_questions?haggle?lowest_percent?
open_shopOpen a new shopshopscan ask firstOpens a new shop at {slug}.resell.store.
nameslugcategory?visibility?
Listings
list_listingsList listingsreadThe seller's listings, most recently changed first, with views, likes and offers for each.
status?shop?limit?offset?
get_listingGet a listingreadEverything about one listing: words, details, photos, price, the private lowest price, research and numbers.
id
create_listingMake a listinglistingsMakes a draft listing. A prompt in the seller's words is enough ("yellow le creuset dutch oven 5.5qt, used twice"); set research: true to have the research agent identify it and suggest a price. Photos can be added from public image URLs. It stays a draft until publish_listing.
shop?prompt?title?one_liner?description?category?price?lowest_price?shipping?take_offers?fields?photo_urls?research?
update_listingChange a listinglistingsChange a listing's words, price, private lowest price, shipping, details, or whether it takes offers. Send only what changes.
idtitle?one_liner?description?category?price?lowest_price?shipping?take_offers?fields?visibility?
publish_listingPut a listing livelistingscan ask firstPublishes a draft on the store. Needs a title and a price. visibility "link" keeps it out of search.
idvisibility?
unpublish_listingTake a listing downlistingsBack to a draft. It keeps its link.
id
mark_sold_elsewhereMark sold elsewherelistingscan ask firstFor something that sold somewhere else. (Sales on resell.store mark themselves sold.)
id
relistRelistlistingscan ask firstPuts a sold listing back up at the same link.
id
delete_listingDelete a listinglistingscan ask firstDeletes a listing and its photos for good. Listings with a sale can't be deleted.
id
Photos
add_photosAdd photoslistingsAdds pictures to a listing from public image URLs (we keep a copy). Up to 12 photos.
idurlsalt?
remove_photoRemove a photolistingsRemoves one photo from a listing.
idphoto_id
reorder_photosReorder photoslistingsSets the photo order; the first is the cover and must be one of the seller's own photos. Send every photo id.
idphoto_ids
Research and words
research_itemWhat's this worth?listingsLooks an item up from a description: what it is, what it sells for second-hand and a suggested price. Makes a draft listing to hold the results; check them with get_research after about a minute.
queryshop?photo_urls?
research_listingLook a listing uplistingsStarts the research agent on an existing listing (identify it, find prices, suggest one). Check with get_research.
id
get_researchResearch resultsreadProgress of the latest research run, then its findings: what it is, a price range and suggested price, facts and questions worth answering.
id
write_listing_wordsWrite the wordslistingsHas the writing agent write the title, one-liner and description from the listing's details, in a tone, and puts them on the listing. instruction can be "shorter", "longer", "take" (a fresh take) or free text.
idtone?instruction?
Offers
list_offersList offersreadOffers on the seller's listings, newest first. status "open" means waiting on the seller.
status?listing?limit?offset?
accept_offerAccept an offerofferscan ask firstSays yes to an open offer. The buyer gets 48 hours to pay.
id
decline_offerDecline an offerofferscan ask firstSays no to an open offer. The buyer is told kindly.
id
counter_offerCounter an offerofferscan ask firstNames a price between the buyer's offer and the asking price. The buyer has 48 hours to take it.
idamount
Sales
list_salesList salesreadWhat sold, newest first. status "paid" means it's waiting to be shipped.
status?limit?offset?
get_saleGet a salereadOne sale: the buyer, the shipping address, the payout and its status.
id
mark_shippedMark shippedorderscan ask firstSays a sale is in the post, with a tracking number if there is one. The buyer gets the tracking link.
idtracking_number?
Messages
list_conversationsList conversationsreadConversations with buyers, newest first.
unread?limit?offset?
read_conversationRead a conversationreadThe whole conversation with a buyer, oldest first, and the listing it's about.
id
reply_to_buyerReply to a buyermessagesSends a reply in a conversation as the shop. Keep it short, friendly and true to the listing; never share the private lowest price.
idbody
mark_conversation_readMark readmessagesMarks a conversation read without replying.
id
Every tool is one or two API calls. search, for example, is GET /v1/market/search.