shopping-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EBAY_CLIENT_ID | Yes | App ID from the production keyset. | |
| EBAY_ENVIRONMENT | No | Set to sandbox to use sandbox keys. | production |
| EBAY_CLIENT_SECRET | Yes | Cert ID from the production keyset. | |
| EBAY_MARKETPLACE_ID | No | Marketplace ID, e.g., EBAY_CA, EBAY_GB, EBAY_AU, EBAY_DE, ... | EBAY_US |
| EBAY_DELIVERY_COUNTRY | No | ISO country code, e.g. CA. | |
| SHOPPING_MCP_TIMEOUT_MS | No | Per-request timeout. | 15000 |
| EBAY_DELIVERY_POSTAL_CODE | No | Improves shipping-cost accuracy. | |
| EBAY_AFFILIATE_CAMPAIGN_ID | No | Returns affiliate-tagged listing links. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_ebayA | Search eBay for listings matching a keyword query, with optional price, condition, buying-format, and shipping filters. Returns title, price, shipping, landed total, seller rating, and a link for each listing. Read-only: this never bids, adds to a cart, or places an order. |
| get_listing_detailsA | Fetch the full record for one eBay listing: price, condition, availability, seller rating, item specifics, return policy, and auction end time. Accepts either the v1|...|0 item id or the legacy numeric id from an eBay URL. |
| find_dealsA | Search eBay for listings currently discounted off their original price. Returns only items whose advertised saving meets the threshold, cheapest landed price first. |
| check_ebay_connectionA | Report how eBay is configured and make one live test call to confirm the credentials work. Run this first whenever a search fails or returns nothing. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Most tools are clearly distinct: check_ebay_connection, search_ebay, get_listing_details each target different actions. search_ebay and find_deals have some overlap, but find_deals is specifically for discounted listings with a savings threshold, so the boundary is clear enough.
Tool names follow a readable snake_case verb_noun pattern: check_ebay_connection, search_ebay, get_listing_details, find_deals. The only minor inconsistency is using both 'search' and 'find' for similar retrieval actions, but the pattern remains predictable.
Four tools is on the small side but appropriate for a focused eBay look-up server. The surface is tight and avoids unnecessary endpoints, though it is slightly minimal for a general 'shopping' MCP.
The tool set covers the core read-only shopping workflow: connectivity verification, keyword search, deal discovery, and listing details. It intentionally omits purchase actions, and while category browsing or seller info could be added, the current surface is not severely incomplete.