ebay-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EBAY_ENV | No | Environment: sandbox (default) or production | sandbox |
| EBAY_CLIENT_ID | Yes | App Id (OAuth Client Id) from Developer Portal | |
| EBAY_OAUTH_SCOPE | No | OAuth scope for ebay-mcp-auth script (optional) | |
| EBAY_ACCESS_TOKEN | No | User access token (optional, can be obtained via ebay-mcp-auth script) | |
| EBAY_DEVELOPER_ID | No | Developer ID (optional, for notifications) | |
| EBAY_REDIRECT_URI | No | Redirect URI registered in Dev Console (for ebay-mcp-auth script) | |
| EBAY_CLIENT_SECRET | Yes | Cert Id (Client Secret) from Developer Portal | |
| EBAY_REFRESH_TOKEN | No | Refresh token for automatic token refresh (recommended for user mode) | |
| EBAY_MARKETPLACE_ID | No | Marketplace ID for Browse API | EBAY_US |
| EBAY_OAUTH_LOCAL_PORT | No | Local port for OAuth callback | 8765 |
| EBAY_APPLICATION_SCOPE | No | Scope for application token | https://api.ebay.com/oauth/api_scope |
| EBAY_ALLOW_APPLICATION_TOKEN | No | Set to false to require user token instead of using application token | true |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| verifyA | Verify credentials. User token: Commerce Identity profile. Application-only keyset: Browse ping + totals. |
| refresh_access_tokenA | Refresh tokens in-process only. User mode: EBAY_REFRESH_TOKEN grant. Application mode: client_credentials refetch. |
| search_item_summaryA | Search marketplace listings (Browse item_summary/search). Typical filters: limit 1–50 for quick previews. category_ids is optional (comma-separated eBay leaf category ids). Sort: omit for Best Match; use |
| get_item_summaryB | GET a single Browse listing by REST item id (encode-safe; pass the v1 item id). |
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
Each tool serves a unique purpose: retrieving a single item, refreshing tokens, searching listings, and verifying credentials. No overlap exists.
All tool names follow a consistent snake_case pattern with descriptive verbs (get, refresh, search, verify). No mixing of conventions.
Four tools are well-scoped for an eBay browsing and authentication server, covering essential operations without unnecessary bloat.
The surface covers browsing (search and get item), token management, and credential verification. For the apparent purpose, no obvious gaps.