.env.example

# eBay MCP Server Configuration

# Required: Your eBay app credentials
EBAY_CLIENT_ID=your-client-id
EBAY_CLIENT_SECRET=your-client-secret
EBAY_REDIRECT_URI=your-redirect-uri
EBAY_ENVIRONMENT=sandbox

# Required: User refresh token (get from eBay OAuth flow)
EBAY_USER_REFRESH_TOKEN=your-refresh-token

# Optional: OAuth auto-capture callback port — used by `npm run setup` → "Auto-capture".
# The wizard runs a loopback server at http://localhost:<port>/oauth/callback. eBay rejects
# http:// and localhost as a RuName auth-accepted URL (HTTPS is mandatory), so front this
# port with an HTTPS tunnel (e.g. `ngrok http 3000`) and register the tunnel's
# https://<host>/oauth/callback URL in the eBay Developer Portal. Default port 3000.
# EBAY_OAUTH_CALLBACK_PORT=3000

# Auto-generated (no need to set manually - will be created automatically)
# EBAY_USER_ACCESS_TOKEN=
# EBAY_APP_ACCESS_TOKEN=

# Logging Configuration
# Log level: error, warn, info, http, verbose, debug, silly (default: info)
# EBAY_LOG_LEVEL=info

# Enable file logging to ~/.ebay-mcp/logs/ (default: false)
# EBAY_ENABLE_FILE_LOGGING=true

# Interactive UI (MCP Apps) — Beta. On hosts that support MCP Apps (e.g. Claude),
# read tools render as interactive table / card / chart views; every other host gets
# the same data as plain JSON. Built on https://github.com/modelcontextprotocol/ext-apps.
# Defaults to "on" (host-gated). Set "off" to force plain JSON everywhere, even on
# capable hosts.
# EBAY_MCP_UI=on

# Authenticating proxy (optional) — https://github.com/YosefHayim/ebay-mcp/issues/122
# Route all outbound eBay traffic (REST, Identity, Trading) through a reverse proxy.
# Trailing slashes are trimmed; the proxy owns the apiz-vs-api routing.
# EBAY_MCP_API_BASE_URL=http://localhost:8080
#
# Offload authentication to the proxy: when true, the server sends NO eBay auth
# (no Bearer, no IAF token) and mints no tokens, so EBAY_CLIENT_ID / EBAY_CLIENT_SECRET
# become optional. Pair it with EBAY_MCP_API_BASE_URL pointing at your proxy.
# EBAY_MCP_DISABLE_AUTH_HEADER=true