ebay-mcp 1.6.2 → 1.7.2

package/README.md

@@ -11,7 +11,7 @@
 [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/yosefhayim-ebay-api-mcp-server-badge.png)](https://mseep.ai/app/yosefhayim-ebay-api-mcp-server)
 <a href="https://www.buymeacoffee.com/yosefhayim" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
 
-A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server providing AI assistants with comprehensive access to eBay's Sell APIs. Includes **387 tools** for inventory management, order fulfillment, marketing campaigns, analytics, developer tools, and more.
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server providing AI assistants with comprehensive access to eBay's Sell APIs. Includes **325 tools** for inventory management, order fulfillment, marketing campaigns, analytics, developer tools, and more.
 
 **API Coverage:** 100% (270 unique eBay API endpoints)
 
@@ -113,7 +113,7 @@ For official eBay API support, please refer to the [eBay Developer Program](http
 
 ## Features
 
-- **387 eBay API Tools** - 100% coverage of eBay Sell APIs across inventory, orders, marketing, analytics, developer tools, and more
+- **325 eBay API Tools** - 100% coverage of eBay Sell APIs across inventory, orders, marketing, analytics, developer tools, and more
 - **9 AI Clients Supported** - Auto-configuration for Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI, and Amazon Q
 - **OAuth 2.0 Support** - Full user token management with automatic refresh
 - **Type Safety** - Built with TypeScript, Zod validation, and OpenAPI-generated types
@@ -223,6 +223,8 @@ EBAY_CLIENT_ID=your_client_id
 EBAY_CLIENT_SECRET=your_client_secret
 EBAY_ENVIRONMENT=sandbox  # or "production"
 EBAY_REDIRECT_URI=your_runame
+EBAY_MARKETPLACE_ID=EBAY_US  # Default marketplace (overridable by many tools)
+EBAY_CONTENT_LANGUAGE=en-US  # Default request content language (global)
 EBAY_USER_REFRESH_TOKEN=your_refresh_token  # For higher rate limits
 ```
 
@@ -260,7 +262,7 @@ This server supports **9 AI clients** with auto-configuration via `npm run setup
 
 ```bash
 npm install -g ebay-mcp
-npx ebay-mcp  # Interactive setup wizard - auto-detects installed clients
+npx ebay-mcp setup  # Interactive setup wizard - auto-detects installed clients
 ```
 
 The setup wizard will automatically detect which AI clients you have installed and configure them for you.
@@ -310,7 +312,7 @@ Monitor your API usage in the [eBay Developer Portal](https://developer.ebay.com
 
 ## Available Tools
 
-The server provides **387 tools** with **100% API coverage** organized into the following categories:
+The server provides **325 tools** with **100% API coverage** organized into the following categories:
 
 - **Account Management** - Policies, programs, subscriptions, sales tax
 - **Inventory Management** - Items, offers, locations, bulk operations, SKU location mapping
@@ -564,7 +566,7 @@ Log files are stored in `~/.ebay-mcp/logs/`:
 
 1. Verify you're using the correct environment (sandbox vs production)
 2. Ensure you have proper permissions/scopes for the operation
-3. Check eBay API status: https://developer.ebay.com/support/api-status
+3. Check current API status with the `ebay_get_api_status` tool or the [eBay API Status](https://developer.ebay.com/support/api-status) page
 4. Run `npm run diagnose` to check your configuration
 5. Review the [eBay API documentation](https://developer.ebay.com/docs) for endpoint requirements
 
@@ -602,12 +604,20 @@ If you're still experiencing issues:
 
 ## Resources
 
+### API Status
+
+Check current eBay API health, incidents, and fixes:
+
+- [eBay API Status](https://developer.ebay.com/support/api-status) - Official status page
+- [API Status RSS feed](https://developer.ebay.com/rss/api-status) - Latest issues and resolutions (XML)
+- **`ebay_get_api_status`** - MCP tool that returns the latest items from this feed (filter by status or API name, optional limit)
+- [Latest snapshot (auto-updated)](docs/API_STATUS.md) - In-repo digest of recent status items
+
 ### Documentation
 
 - [eBay Developer Portal](https://developer.ebay.com/) - API documentation and credentials
 - [eBay API License Agreement](https://developer.ebay.com/join/api-license-agreement) - Terms of use and compliance requirements
 - [eBay Data Handling Requirements](https://developer.ebay.com/api-docs/static/data-handling-update.html) - Important data protection and privacy guidelines
-- [eBay API Status](https://developer.ebay.com/support/api-status) - Real-time API health and status
 - [MCP Documentation](https://modelcontextprotocol.io/) - Model Context Protocol specification
 - [OAuth Quick Reference](docs/auth/OAUTH_QUICK_REFERENCE.md) - **Complete OAuth authentication guide with scopes, troubleshooting, and examples**
 - [OAuth Setup Guide](docs/auth/) - Detailed authentication configuration

package/build/api/client.js

@@ -37,6 +37,22 @@ export class EbayApiClient {
     baseUrl;
     rateLimitTracker;
     config;
+    /**
+     * Build default request headers based on configured marketplace and language.
+     */
+    getDefaultHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        };
+        if (this.config.contentLanguage) {
+            headers['Content-Language'] = this.config.contentLanguage;
+        }
+        if (this.config.marketplaceId) {
+            headers['X-EBAY-C-MARKETPLACE-ID'] = this.config.marketplaceId;
+        }
+        return headers;
+    }
     constructor(config) {
         this.config = config;
         this.authClient = new EbayOAuthClient(config);
@@ -45,10 +61,7 @@ export class EbayApiClient {
         this.httpClient = axios.create({
             baseURL: this.baseUrl,
             timeout: 30000,
-            headers: {
-                'Content-Type': 'application/json',
-                Accept: 'application/json',
-            },
+            headers: this.getDefaultHeaders(),
         });
         // Add request interceptor to inject auth token and check rate limits
         this.httpClient.interceptors.request.use(async (config) => {
@@ -149,7 +162,9 @@ export class EbayApiClient {
                         attempt: `${retryCount + 1}/3`,
                         delayMs: Math.min(delay, 5000),
                     });
-                    await new Promise((resolve) => setTimeout(resolve, Math.min(delay, 5000)));
+                    await new Promise((resolve) => {
+                        setTimeout(resolve, Math.min(delay, 5000));
+                    });
                     return await this.httpClient.request(config);
                 }
             }
@@ -168,8 +183,8 @@ export class EbayApiClient {
      * Validate that access token is available before making API request
      */
     validateAccessToken() {
-        if (!this.authClient.hasUserTokens()) {
-            throw new Error('Access token is missing. Please provide your access token and refresh token by calling ebay_set_user_tokens tool in order to perform API requests.');
+        if (!this.config.clientId || !this.config.clientSecret) {
+            throw new Error('Missing required eBay credentials. Please set EBAY_CLIENT_ID and EBAY_CLIENT_SECRET in your .env file.');
         }
     }
     /**
@@ -225,8 +240,8 @@ export class EbayApiClient {
     /**
      * Set user access and refresh tokens
      */
-    async setUserTokens(accessToken, refreshToken) {
-        await this.authClient.setUserTokens(accessToken, refreshToken);
+    async setUserTokens(accessToken, refreshToken, accessTokenExpiry, refreshTokenExpiry) {
+        this.authClient.setUserTokens(accessToken, refreshToken, accessTokenExpiry, refreshTokenExpiry);
     }
     /**
      * Get token information for debugging
@@ -281,8 +296,7 @@ export class EbayApiClient {
                 params,
                 headers: {
                     Authorization: `Bearer ${token}`,
-                    'Content-Type': 'application/json',
-                    Accept: 'application/json',
+                    ...this.getDefaultHeaders(),
                 },
                 timeout: 30000,
             });
@@ -303,8 +317,7 @@ export class EbayApiClient {
                         params,
                         headers: {
                             Authorization: `Bearer ${token}`,
-                            'Content-Type': 'application/json',
-                            Accept: 'application/json',
+                            ...this.getDefaultHeaders(),
                         },
                         timeout: 30000,
                     });

package/build/api/index.js

@@ -87,8 +87,8 @@ export class EbaySellerApi {
     /**
      * Set user access and refresh tokens
      */
-    async setUserTokens(accessToken, refreshToken) {
-        await this.client.setUserTokens(accessToken, refreshToken);
+    async setUserTokens(accessToken, refreshToken, accessTokenExpiry, refreshTokenExpiry) {
+        await this.client.setUserTokens(accessToken, refreshToken, accessTokenExpiry, refreshTokenExpiry);
     }
     /**
      * Get OAuth client for advanced operations

package/build/api/listing-management/inventory.js

@@ -60,11 +60,7 @@ export class InventoryApi {
             throw new Error('inventoryItem is required and must be an object');
         }
         try {
-            return await this.client.put(`${this.basePath}/inventory_item/${sku}`, inventoryItem, {
-                headers: {
-                    'Content-Language': 'en-US',
-                },
-            });
+            return await this.client.put(`${this.basePath}/inventory_item/${sku}`, inventoryItem);
         }
         catch (error) {
             throw new Error(`Failed to create or replace inventory item: ${error instanceof Error ? error.message : 'Unknown error'}`);
@@ -95,11 +91,7 @@ export class InventoryApi {
             throw new Error('requests is required and must be an object');
         }
         try {
-            return await this.client.post(`${this.basePath}/bulk_create_or_replace_inventory_item`, requests, {
-                headers: {
-                    'Content-Language': 'en-US',
-                },
-            });
+            return await this.client.post(`${this.basePath}/bulk_create_or_replace_inventory_item`, requests);
         }
         catch (error) {
             throw new Error(`Failed to bulk create or replace inventory items: ${error instanceof Error ? error.message : 'Unknown error'}`);
@@ -166,11 +158,7 @@ export class InventoryApi {
             throw new Error('compatibility is required and must be an object');
         }
         try {
-            return await this.client.put(`${this.basePath}/inventory_item/${sku}/product_compatibility`, compatibility, {
-                headers: {
-                    'Content-Language': 'en-US',
-                },
-            });
+            return await this.client.put(`${this.basePath}/inventory_item/${sku}/product_compatibility`, compatibility);
         }
         catch (error) {
             throw new Error(`Failed to create or replace product compatibility: ${error instanceof Error ? error.message : 'Unknown error'}`);
@@ -221,11 +209,7 @@ export class InventoryApi {
             throw new Error('inventoryItemGroup is required and must be an object');
         }
         try {
-            return await this.client.put(`${this.basePath}/inventory_item_group/${inventoryItemGroupKey}`, inventoryItemGroup, {
-                headers: {
-                    'Content-Language': 'en-US',
-                },
-            });
+            return await this.client.put(`${this.basePath}/inventory_item_group/${inventoryItemGroupKey}`, inventoryItemGroup);
         }
         catch (error) {
             throw new Error(`Failed to create or replace inventory item group: ${error instanceof Error ? error.message : 'Unknown error'}`);
@@ -431,11 +415,7 @@ export class InventoryApi {
             throw new Error('offer is required and must be an object');
         }
         try {
-            return await this.client.post(`${this.basePath}/offer`, offer, {
-                headers: {
-                    'Content-Language': 'en-US',
-                },
-            });
+            return await this.client.post(`${this.basePath}/offer`, offer);
         }
         catch (error) {
             throw new Error(`Failed to create offer: ${error instanceof Error ? error.message : 'Unknown error'}`);
@@ -454,11 +434,7 @@ export class InventoryApi {
             throw new Error('offer is required and must be an object');
         }
         try {
-            return await this.client.put(`${this.basePath}/offer/${offerId}`, offer, {
-                headers: {
-                    'Content-Language': 'en-US',
-                },
-            });
+            return await this.client.put(`${this.basePath}/offer/${offerId}`, offer);
         }
         catch (error) {
             throw new Error(`Failed to update offer: ${error instanceof Error ? error.message : 'Unknown error'}`);
@@ -521,11 +497,7 @@ export class InventoryApi {
             throw new Error('requests is required and must be an object');
         }
         try {
-            return await this.client.post(`${this.basePath}/bulk_create_offer`, requests, {
-                headers: {
-                    'Content-Language': 'en-US',
-                },
-            });
+            return await this.client.post(`${this.basePath}/bulk_create_offer`, requests);
         }
         catch (error) {
             throw new Error(`Failed to bulk create offers: ${error instanceof Error ? error.message : 'Unknown error'}`);

package/build/api/other/identity.js

@@ -18,7 +18,7 @@ export class IdentityApi {
     async getUser() {
         const config = this.client.getConfig();
         const identityBaseUrl = getIdentityBaseUrl(config.environment);
-        const fullUrl = `${identityBaseUrl}${this.basePath}/user/`;
+        const fullUrl = `${identityBaseUrl}${this.basePath}/user`;
         return await this.client.getWithFullUrl(fullUrl);
     }
 }

package/build/auth/oauth.js

@@ -1,7 +1,7 @@
 import axios from 'axios';
 import { getBaseUrl, getDefaultScopes } from '../config/environment.js';
 import { LocaleEnum } from '../types/ebay-enums.js';
-import { readFileSync, writeFileSync } from 'fs';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { authLogger } from '../utils/logger.js';
 /**
@@ -10,7 +10,7 @@ import { authLogger } from '../utils/logger.js';
 function updateEnvFile(updates) {
     try {
         const envPath = join(process.cwd(), '.env');
-        let envContent = readFileSync(envPath, 'utf-8');
+        let envContent = existsSync(envPath) ? readFileSync(envPath, 'utf-8') : '';
         // Update each key-value pair
         for (const [key, value] of Object.entries(updates)) {
             // Match the key with or without value, handling comments
@@ -28,7 +28,7 @@ function updateEnvFile(updates) {
         writeFileSync(envPath, envContent, 'utf-8');
         // Tokens updated silently - console output interferes with MCP JSON protocol
     }
-    catch (error) {
+    catch (_error) {
         // Silent failure - error logging interferes with MCP JSON protocol
         // If needed, check .env file manually
     }
@@ -180,7 +180,7 @@ export class EbayOAuthClient {
      */
     async getOrRefreshAppAccessToken() {
         // Return cached token if still valid
-        if (this.appAccessToken) {
+        if (this.appAccessToken && Date.now() < this.appAccessTokenExpiry) {
             return this.appAccessToken;
         }
         const authUrl = `${getBaseUrl(this.config.environment)}/identity/v1/oauth2/token`;

package/build/config/environment.js

@@ -1,8 +1,9 @@
 import { config } from 'dotenv';
-import { readFileSync } from 'fs';
+import { existsSync, readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { LocaleEnum } from '../types/ebay-enums.js';
+import { getVersion } from '../utils/version.js';
 // Load .env silently - suppress dotenv output to keep stdout clean for MCP JSON-RPC
 config({ quiet: true });
 // Get the current directory for loading scope files
@@ -58,7 +59,10 @@ function getSandboxScopes() {
  * Get default scopes for the specified environment
  */
 export function getDefaultScopes(environment) {
-    return environment === 'production' ? getProductionScopes() : getSandboxScopes();
+    if (environment === 'production') {
+        return getProductionScopes();
+    }
+    return getSandboxScopes();
 }
 /**
  * Validate scopes against environment and return warnings for invalid scopes
@@ -134,6 +138,9 @@ export function validateEnvironmentConfig() {
         errors,
     };
 }
+/**
+ * Build EbayConfig from environment variables with safe defaults.
+ */
 export function getEbayConfig() {
     const clientId = process.env.EBAY_CLIENT_ID ?? '';
     const clientSecret = process.env.EBAY_CLIENT_SECRET ?? '';
@@ -141,6 +148,8 @@ export function getEbayConfig() {
     const accessToken = process.env.EBAY_USER_ACCESS_TOKEN ?? '';
     const refreshToken = process.env.EBAY_USER_REFRESH_TOKEN ?? '';
     const appAccessToken = process.env.EBAY_APP_ACCESS_TOKEN ?? '';
+    const marketplaceId = (process.env.EBAY_MARKETPLACE_ID ?? '').trim() || 'EBAY_US';
+    const contentLanguage = (process.env.EBAY_CONTENT_LANGUAGE ?? '').trim() || 'en-US';
     // Only require client credentials - tokens can be optional (generated from refresh token)
     if (clientId === '' || clientSecret === '') {
         console.error('Missing required eBay credentials. Please set:\n1) EBAY_CLIENT_ID\n2) EBAY_CLIENT_SECRET\nin your .env file at project root');
@@ -149,6 +158,8 @@ export function getEbayConfig() {
         clientId,
         clientSecret,
         redirectUri: process.env.EBAY_REDIRECT_URI,
+        marketplaceId,
+        contentLanguage,
         environment,
         accessToken,
         refreshToken,
@@ -172,23 +183,23 @@ export function getAuthUrl(clientIdOrEnvironment, redirectUri, environment, loca
     }
     // Otherwise, generate the full OAuth authorization URL
     const clientId = clientIdOrEnvironment;
-    const env = environment || 'sandbox';
+    const env = environment ?? 'sandbox';
     const scope = getDefaultScopes(env);
     if (!(clientId && redirectUri)) {
         console.error('clientId, redirectUri (RuName), and scope are required,please initialize the class properly.');
         return '';
     }
-    const authDomain = env === 'production' ? 'https://auth.ebay.com' : 'https://auth.sandbox.ebay.com';
-    const params = new URLSearchParams({
+    const authBase = env === 'production' ? 'https://auth.ebay.com' : 'https://auth.sandbox.ebay.com';
+    const scopeList = scopes?.join('%20') || scope.join('%20');
+    const authorizeParams = new URLSearchParams({
         client_id: clientId,
         redirect_uri: redirectUri,
         response_type: responseType,
-        scope: scopes?.join(' ') || scope.join(' '),
         prompt,
         locale,
         ...(state ? { state } : {}),
     });
-    return `${authDomain}/oauth2/authorize?${params.toString()}`;
+    return `${authBase}/oauth2/authorize?${authorizeParams.toString()}&scope=${scopeList}`;
 }
 /**
  * Generate the OAuth authorization URL for user consent
@@ -199,62 +210,69 @@ export function getAuthUrl(clientIdOrEnvironment, redirectUri, environment, loca
  */
 export function getOAuthAuthorizationUrl(clientId, redirectUri, // MUST be eBay RuName, NOT a URL
 environment, scopes, locale, state) {
-    // Build the authorize URL using auth2 endpoint (correct eBay OAuth endpoint)
-    const authDomain = environment === 'production' ? 'https://auth2.ebay.com' : 'https://auth2.sandbox.ebay.com';
-    const authorizeEndpoint = `${authDomain}/oauth2/authorize`;
-    // Build query parameters for the authorize endpoint
-    const params = new URLSearchParams({
-        client_id: clientId,
-        redirect_uri: redirectUri,
-    });
-    // Add scopes only if provided (optional - eBay handles automatically if not specified)
+    const authBase = environment === 'production' ? 'https://auth.ebay.com' : 'https://auth.sandbox.ebay.com';
+    let scopeList;
     if (scopes && scopes.length > 0) {
-        params.append('scope', scopes.join(' '));
+        scopeList = scopes.join('%20');
     }
     else {
-        // Use default scopes for the environment if no scopes are specified
         const defaultScopes = getDefaultScopes(environment);
-        params.append('scope', defaultScopes.join(' '));
+        scopeList = defaultScopes.join('%20');
     }
-    // Always add state parameter (empty if not provided)
-    params.append('state', state || '');
-    // Add response_type
-    params.append('response_type', 'code');
-    // Add hd parameter (required by eBay)
-    params.append('hd', '');
-    // Build the signin URL that redirects to authorize
-    const signinDomain = environment === 'production' ? 'https://signin.ebay.com' : 'https://signin.sandbox.ebay.com';
-    const ruParam = encodeURIComponent(`${authorizeEndpoint}?${params.toString()}`);
-    return `${signinDomain}/signin?ru=${ruParam}&sgfl=oauth2_login&AppName=${clientId}`;
+    const params = new URLSearchParams({
+        client_id: clientId,
+        redirect_uri: redirectUri,
+        response_type: 'code',
+        ...(state ? { state } : {}),
+    });
+    return `${authBase}/oauth2/authorize?${params.toString()}&scope=${scopeList}`;
 }
+const iconUrl = (size) => {
+    const url = new URL(`../../public/icons/${size}.png`, import.meta.url);
+    const path = fileURLToPath(url);
+    if (!existsSync(path)) {
+        console.warn(`[eBay MCP] Icon not found at ${path}. Ensure public/icons is included in the package.`);
+    }
+    return url.toString();
+};
 export const mcpConfig = {
     name: 'eBay API Model Context Protocol Server',
-    version: '1.4.2',
+    version: getVersion(),
     title: 'eBay API Model Context Protocol Server',
-    websiteUrl: 'https://github.com/ebay/ebay-mcp-server',
+    websiteUrl: 'https://github.com/YosefHayim/ebay-mcp',
     icons: [
         {
-            src: './48x48.png',
+            src: iconUrl('16x16'),
+            mimeType: 'image/png',
+            sizes: ['16x16'],
+        },
+        {
+            src: iconUrl('32x32'),
+            mimeType: 'image/png',
+            sizes: ['32x32'],
+        },
+        {
+            src: iconUrl('48x48'),
             mimeType: 'image/png',
             sizes: ['48x48'],
         },
         {
-            src: './128x128.png',
+            src: iconUrl('128x128'),
             mimeType: 'image/png',
             sizes: ['128x128'],
         },
         {
-            src: './256x256.png',
+            src: iconUrl('256x256'),
             mimeType: 'image/png',
             sizes: ['256x256'],
         },
         {
-            src: './512x512.png',
+            src: iconUrl('512x512'),
             mimeType: 'image/png',
             sizes: ['512x512'],
         },
         {
-            src: './1024x1024.png',
+            src: iconUrl('1024x1024'),
             mimeType: 'image/png',
             sizes: ['1024x1024'],
         },

package/build/index.js

@@ -5,6 +5,20 @@ import { EbaySellerApi } from './api/index.js';
 import { getEbayConfig, mcpConfig, validateEnvironmentConfig } from './config/environment.js';
 import { getToolDefinitions, executeTool } from './tools/index.js';
 import { serverLogger, toolLogger, getLogPaths } from './utils/logger.js';
+import { checkForUpdates } from './utils/version.js';
+checkForUpdates({ defer: true });
+const args = process.argv.slice(2);
+if (args.includes('setup')) {
+    try {
+        const { runSetup } = await import('./scripts/setup.js');
+        await runSetup();
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Setup failed:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
 /**
  * eBay API MCP Server
  * Provides access to eBay APIs through Model Context Protocol

package/build/scripts/auto-setup.js

@@ -135,6 +135,12 @@ function generateMCPServerConfig() {
     if (process.env.EBAY_REDIRECT_URI) {
         config.env.EBAY_REDIRECT_URI = process.env.EBAY_REDIRECT_URI;
     }
+    if (process.env.EBAY_MARKETPLACE_ID) {
+        config.env.EBAY_MARKETPLACE_ID = process.env.EBAY_MARKETPLACE_ID;
+    }
+    if (process.env.EBAY_CONTENT_LANGUAGE) {
+        config.env.EBAY_CONTENT_LANGUAGE = process.env.EBAY_CONTENT_LANGUAGE;
+    }
     if (process.env.EBAY_USER_ACCESS_TOKEN) {
         config.env.EBAY_USER_ACCESS_TOKEN = process.env.EBAY_USER_ACCESS_TOKEN;
     }

package/build/scripts/diagnostics.js

@@ -118,6 +118,8 @@ function displayConfigurationStatus(envVars) {
         { key: 'EBAY_CLIENT_SECRET', label: 'Client Secret', redact: true },
         { key: 'EBAY_REDIRECT_URI', label: 'Redirect URI', redact: false },
         { key: 'EBAY_ENVIRONMENT', label: 'Environment', redact: false },
+        { key: 'EBAY_MARKETPLACE_ID', label: 'Marketplace ID', redact: false },
+        { key: 'EBAY_CONTENT_LANGUAGE', label: 'Content Language', redact: false },
         { key: 'EBAY_USER_REFRESH_TOKEN', label: 'User Refresh Token', redact: true },
         { key: 'EBAY_USER_ACCESS_TOKEN', label: 'User Access Token', redact: true },
         { key: 'EBAY_APP_ACCESS_TOKEN', label: 'App Access Token', redact: true },

package/build/scripts/interactive-setup.js

@@ -143,6 +143,10 @@ EBAY_REDIRECT_URI=${config.EBAY_REDIRECT_URI || 'http://localhost:3000/oauth/cal
 # ═══════════════════════════════════════════════════════════════════
 
 EBAY_ENVIRONMENT=${config.EBAY_ENVIRONMENT || 'sandbox'}
+# Optional: e.g. EBAY_US, EBAY_DE, EBAY_FR
+EBAY_MARKETPLACE_ID=${config.EBAY_MARKETPLACE_ID || ''}
+# Optional: e.g. en-US, de-DE, fr-FR
+EBAY_CONTENT_LANGUAGE=${config.EBAY_CONTENT_LANGUAGE || ''}
 
 # ═══════════════════════════════════════════════════════════════════
 # User Tokens (Auto-generated from refresh token)
@@ -667,6 +671,8 @@ async function runInteractiveSetup(args) {
         EBAY_CLIENT_SECRET: credentials.EBAY_CLIENT_SECRET,
         EBAY_REDIRECT_URI: credentials.EBAY_REDIRECT_URI,
         EBAY_ENVIRONMENT: environment,
+        EBAY_MARKETPLACE_ID: existingConfig.EBAY_MARKETPLACE_ID || '',
+        EBAY_CONTENT_LANGUAGE: existingConfig.EBAY_CONTENT_LANGUAGE || '',
         EBAY_USER_REFRESH_TOKEN: refreshToken,
         EBAY_USER_ACCESS_TOKEN: '',
         EBAY_APP_ACCESS_TOKEN: '',