MCP server

Your shops

The seller's server: everything you do in the app, from asking your AI.

Address

https://mcp.resell.store/u/your-private-link

Each 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 meread

Everything waiting on the seller right now: offers to answer, sales to ship, unread buyer messages. Call this first.

whoamiWho am Iread

The account this connection belongs to, its shops and what this connection is allowed to do.

get_statsShop statsread

How 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 shopsread

The seller's shops with their settings and listing counts.

get_shopGet a shopread

One shop's settings and this week's numbers.

shop

update_shopChange shop settingsshopscan ask first

Change 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 first

Opens a new shop at {slug}.resell.store.

nameslugcategory?visibility?

Listings

list_listingsList listingsread

The seller's listings, most recently changed first, with views, likes and offers for each.

status?shop?limit?offset?

get_listingGet a listingread

Everything about one listing: words, details, photos, price, the private lowest price, research and numbers.

id

create_listingMake a listinglistings

Makes 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 listinglistings

Change 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 first

Publishes a draft on the store. Needs a title and a price. visibility "link" keeps it out of search.

idvisibility?

unpublish_listingTake a listing downlistings

Back to a draft. It keeps its link.

id

mark_sold_elsewhereMark sold elsewherelistingscan ask first

For something that sold somewhere else. (Sales on resell.store mark themselves sold.)

id

relistRelistlistingscan ask first

Puts a sold listing back up at the same link.

id

delete_listingDelete a listinglistingscan ask first

Deletes a listing and its photos for good. Listings with a sale can't be deleted.

id

Photos

add_photosAdd photoslistings

Adds pictures to a listing from public image URLs (we keep a copy). Up to 12 photos.

idurlsalt?

remove_photoRemove a photolistings

Removes one photo from a listing.

idphoto_id

reorder_photosReorder photoslistings

Sets 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?listings

Looks 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 uplistings

Starts the research agent on an existing listing (identify it, find prices, suggest one). Check with get_research.

id

get_researchResearch resultsread

Progress 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 wordslistings

Has 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 offersread

Offers on the seller's listings, newest first. status "open" means waiting on the seller.

status?listing?limit?offset?

accept_offerAccept an offerofferscan ask first

Says yes to an open offer. The buyer gets 48 hours to pay.

id

decline_offerDecline an offerofferscan ask first

Says no to an open offer. The buyer is told kindly.

id

counter_offerCounter an offerofferscan ask first

Names a price between the buyer's offer and the asking price. The buyer has 48 hours to take it.

idamount

Sales

list_salesList salesread

What sold, newest first. status "paid" means it's waiting to be shipped.

status?limit?offset?

get_saleGet a saleread

One sale: the buyer, the shipping address, the payout and its status.

id

mark_shippedMark shippedorderscan ask first

Says 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 conversationsread

Conversations with buyers, newest first.

unread?limit?offset?

read_conversationRead a conversationread

The whole conversation with a buyer, oldest first, and the listing it's about.

id

reply_to_buyerReply to a buyermessages

Sends 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 readmessages

Marks a conversation read without replying.

id

Every tool is one or two API calls. search, for example, is GET /v1/market/search.