The Shelvio MCP server
Already work in Claude Code, Codex, Cursor, or VS Code? Add Shelvio there and handle your listings from the same place. It is the same Shelvio connection that works in ChatGPT and Claude, a remote MCP server: create listings from photos, edit them, track where items are listed and sold, and get eBay listings ready for you to publish.
Using ChatGPT or Claude? Follow the two-minute setup instead.
Server details
- Endpoint
- https://api.shelvio.ai/mcp
- Transport
- Streamable HTTP
- Auth
- OAuth 2.1 with PKCE, discovered from the server. Scopes: shelvio:read and shelvio:write.
- Interface
- MCP Apps cards for items and eBay previews in hosts that render them; text results everywhere else.
- Tenancy
- Each seller signs in with their own account. Tools act only on that seller’s workspace.
- Limits
- The same plan and listing allowance as the Shelvio app, plus per-seller action limits.
Add it to your client
Claude Code. Run this, then type /mcp to sign in.
claude mcp add --transport http shelvio https://api.shelvio.ai/mcp Codex. Add the server, then sign in.
codex mcp add shelvio --url https://api.shelvio.ai/mcp
codex mcp login shelvio Cursor. In ~/.cursor/mcp.json:
{
"mcpServers": {
"shelvio": { "url": "https://api.shelvio.ai/mcp" }
}
} VS Code. In .vscode/mcp.json, or run MCP: Add Server and choose HTTP:
{
"servers": {
"shelvio": { "type": "http", "url": "https://api.shelvio.ai/mcp" }
}
} Tested end to end in ChatGPT and Claude. Other clients connect through the same MCP standard and OAuth discovery.
Tools
| Tool | What it does |
|---|---|
| get_account_status | Plan, AI permission, and eBay connection, with the next setup step. |
| find_items | Search inventory by title, batch, listing state, SKU, or storage location. |
| get_item | One item’s full listing, photos, and marketplace status. |
| list_batches | Your batches and how many items in each are ready. |
| create_listing | Start a listing from photos of one item (attached files or HTTPS links) and what you said about it. |
| update_item | Change listing fields or inventory details: price, cost, source, storage, SKU. |
| edit_item_with_ai | Rewrite a listing from a plain-language instruction. |
| get_listing_copy | Marketplace-styled title, description, and price ready to paste. |
| set_marketplace_status | Record a listing or sale on eBay, Poshmark, Mercari, Facebook Marketplace, Depop, or Etsy, with fees and shipping. |
| delete_item | Remove an item from Shelvio. |
| connect_ebay | Link your eBay seller account through eBay’s own sign-in. |
| check_ebay_readiness | What eBay still needs before the item can list, with category choices. |
| set_ebay_category | Choose from the eBay categories readiness offered. |
| set_ebay_item_specifics | Fill or correct eBay item specifics. |
| prepare_ebay_listing | Have eBay verify the listing and show the full preview with a List on eBay button. |
| set_ebay_price | Change the price of a live eBay listing Shelvio published. |
| end_ebay_listing | End a live eBay listing Shelvio published. |
| publish_to_ebay | App-onlyMarked app-only. Card hosts call it when the seller presses List on eBay in a preview, with a single-use review token. |
| prepare_photo_upload, complete_photo_upload | App-onlyMarked app-only. Used by a photo card that is still being rolled out; agents should send photos to create_listing instead. |
Built to keep sellers in control
Publishing is a human press
publish_to_ebay is marked app-only, so hosts that render cards hide it from the model and call it only when the seller presses List on eBay. Its single-use review token is tied to the verified preview and the seller’s own price, and is returned only in result _meta, never in the model-facing text. Hosts without cards send the seller to the web app.
Honest annotations
Every tool declares readOnly, destructive, and openWorld hints, so hosts can ask before risky calls. Tools that delete an item, end an eBay listing, change a live eBay price, or mark an item sold also tell the model to check with the seller first.
No price research in chat
Shelvio does not research or suggest prices through MCP. An item’s price is the seller’s own or its live marketplace price; eBay listing needs the seller’s price.
Private by default
No buyer names, addresses, contact details, or messages in any tool. Private notes and voice transcripts stay out of results, and photo links are signed for an hour and returned only in result _meta for the card.