ebay-mcp 1.6.1 → 1.7.1

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)
 
@@ -99,6 +99,7 @@ For official eBay API support, please refer to the [eBay Developer Program](http
 - [⚠️ Disclaimer](#️-disclaimer)
 - [Features](#features)
 - [Quick Start](#quick-start)
+- [Demo](#demo)
 - [Visual Setup Guide](#visual-setup-guide)
 - [Configuration](#configuration)
 - [Available Tools](#available-tools)
@@ -112,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
@@ -147,122 +148,65 @@ npm install
 npm run build
 ```
 
-### 3. Configure
+### 3. Run Setup Wizard
 
-Run the interactive setup wizard:
+The interactive setup wizard handles everything for you:
 
 ```bash
 npm run setup
 ```
 
-Or configure manually by copying `.env.example` to `.env` and editing your credentials.
+The wizard will:
+- Configure your eBay credentials
+- Set up OAuth authentication (for higher rate limits)
+- Auto-detect and configure your MCP client (Claude Desktop, etc.)
+- Save all configuration automatically
 
 ---
 
-## Visual Setup Guide
+## Demo
 
-Follow these steps to configure OAuth authentication for higher rate limits (10k-50k requests/day):
+See the eBay MCP Server in action with Claude Desktop:
 
-### Step 1: Copy Client ID and Client Secret
+https://github.com/user-attachments/assets/0173c8df-221c-4943-a4ce-cd20bce79f4b
 
-Navigate to the [eBay Developer Portal](https://developer.ebay.com/my/keys) and copy your **App ID (Client ID)** and **Cert ID (Client Secret)** from either Sandbox or Production environment.
+---
 
-![Step 1 - Copy credentials from eBay Developer Portal](public/screenshot-guides/STEP%20-%201%20-%20COPY%20CLIENT%20ID%20AND%20CLIENT%20SECRET%20TO%20ENV%20FILE.png)
+## Visual Setup Guide
 
-Add these credentials to your `.env` file:
-```bash
-EBAY_CLIENT_ID=your_app_id_here
-EBAY_CLIENT_SECRET=your_cert_id_here
-EBAY_ENVIRONMENT=sandbox  # or "production"
-```
+The setup wizard (`npm run setup`) handles OAuth authentication automatically. Here's where to find your credentials in the eBay Developer Portal:
 
-### Step 2: Copy Your Redirect URL (RuName)
+### Finding Your Credentials
 
-In the Developer Portal, go to your application's **User Tokens** settings and copy the **RuName** (eBay Redirect URL). This is required for OAuth authentication.
+**Step 1:** Navigate to [eBay Developer Portal](https://developer.ebay.com/my/keys) and copy your **App ID (Client ID)** and **Cert ID (Client Secret)**:
 
-![Step 2 - Copy RuName from eBay Sign-in Settings](public/screenshot-guides/STEP%20-%202%20-%20COPY%20REDIRECT%20URL.png)
+![Step 1 - Copy credentials from eBay Developer Portal](public/screenshot-guides/STEP%20-%201%20-%20COPY%20CLIENT%20ID%20AND%20CLIENT%20SECRET%20TO%20ENV%20FILE.png)
 
-Add the RuName to your `.env` file:
-```bash
-EBAY_REDIRECT_URI=your_runame_here
-```
+**Step 2:** In your app's **User Tokens** settings, copy the **RuName** (eBay Redirect URL):
 
-### Step 3: Run Setup and Complete OAuth Login
+![Step 2 - Copy RuName from eBay Sign-in Settings](public/screenshot-guides/STEP%20-%202%20-%20COPY%20REDIRECT%20URL.png)
 
-Run the setup wizard which will open your browser automatically:
+### Running the Setup Wizard
 
-```bash
-npm run setup
-```
+Run `npm run setup` and enter your credentials when prompted. The wizard will:
 
-Sign in to your eBay account when prompted to authorize the application.
+1. Open your browser for OAuth login automatically
+2. Guide you through the eBay sign-in process
 
 ![Step 3 - Sign in to eBay during OAuth flow](public/screenshot-guides/STEP%203%20-%20RUN%20COMMAND%20NPM%20RUN%20SETUP%20AND%20PREFORM%20OAUTH%20LOGIN.png)
 
-### Step 4: Paste the Authorization Code
-
-After granting permissions, you'll be redirected to a URL containing an authorization code. Copy the **code** parameter from the URL and paste it into the setup wizard terminal.
+3. Ask you to paste the authorization code from the callback URL
 
 ![Step 4 - Paste authorization code into setup wizard](public/screenshot-guides/STEP%20-%204%20-%20PASTE%20INTO%20THE%20SETUP%20WIZARD.png)
 
-The setup wizard will automatically exchange the code for tokens and save your refresh token to the `.env` file.
+4. Exchange the code for tokens and save them automatically
+5. Configure your MCP client (Claude Desktop, etc.)
 
 **Success!** You now have user token authentication with 10k-50k requests/day instead of the default 1k/day.
 
 ---
 
-### 4. Configure MCP Client
-
-Add this server to your MCP client configuration:
-
-**Claude Desktop:**
-
-Edit your Claude Desktop config file:
-
-- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- Windows: `%APPDATA%/Claude/claude_desktop_config.json`
-- Linux: `~/.config/Claude/claude_desktop_config.json`
-
-Add the server configuration:
-
-```json
-{
-  "mcpServers": {
-    "ebay": {
-      "command": "npx",
-      "args": ["-y", "ebay-mcp"],
-      "env": {
-        "EBAY_CLIENT_ID": "your_client_id",
-        "EBAY_CLIENT_SECRET": "your_client_secret",
-        "EBAY_ENVIRONMENT": "sandbox",
-        "EBAY_REDIRECT_URI": "your_runame"
-      }
-    }
-  }
-}
-```
-
-**Alternative: Use locally installed version**
-
-If you installed from source:
-
-```json
-{
-  "mcpServers": {
-    "ebay": {
-      "command": "node",
-      "args": ["/absolute/path/to/ebay-mcp/build/index.js"],
-      "env": {
-        "EBAY_CLIENT_ID": "your_client_id",
-        "EBAY_CLIENT_SECRET": "your_client_secret",
-        "EBAY_ENVIRONMENT": "sandbox"
-      }
-    }
-  }
-}
-```
-
-### 5. Use
+### 4. Use
 
 Restart your MCP client (Claude Desktop, etc.) and start using eBay tools through your AI assistant.
 
@@ -272,32 +216,21 @@ Restart your MCP client (Claude Desktop, etc.) and start using eBay tools throug
 
 ### Environment Variables
 
-Create a `.env` file with your eBay credentials:
+The setup wizard (`npm run setup`) automatically creates and configures your `.env` file. For reference, these are the environment variables used:
 
 ```bash
 EBAY_CLIENT_ID=your_client_id
 EBAY_CLIENT_SECRET=your_client_secret
 EBAY_ENVIRONMENT=sandbox  # or "production"
 EBAY_REDIRECT_URI=your_runame
-
-# Optional: For higher rate limits (10k-50k req/day)
-EBAY_USER_REFRESH_TOKEN=your_refresh_token
+EBAY_USER_REFRESH_TOKEN=your_refresh_token  # For higher rate limits
 ```
 
 ### OAuth Authentication
 
-**Client Credentials (Automatic):**
-
-- Default authentication method
-- 1,000 requests/day
-- No setup required beyond client ID and secret
+**Client Credentials (Default):** 1,000 requests/day - works automatically with just Client ID and Secret.
 
-**User Tokens (Recommended for Production):**
-
-- 10,000-50,000 requests/day
-- Use `ebay_get_oauth_url` tool to generate authorization URL
-- Add `EBAY_USER_REFRESH_TOKEN` to `.env` after OAuth flow
-- Tokens refresh automatically
+**User Tokens (Recommended):** 10,000-50,000 requests/day - the setup wizard handles the OAuth flow automatically. Tokens refresh automatically.
 
 For detailed OAuth setup and comprehensive configuration guide, see the [Configuration Documentation](docs/auth/CONFIGURATION.md).
 
@@ -327,7 +260,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.
@@ -377,7 +310,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
@@ -631,7 +564,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
 
@@ -669,12 +602,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

@@ -149,7 +149,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 +170,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 +227,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

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/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,16 @@ function getSandboxScopes() {
  * Get default scopes for the specified environment
  */
 export function getDefaultScopes(environment) {
-    return environment === 'production' ? getProductionScopes() : getSandboxScopes();
+    if (environment === 'production') {
+        return getProductionScopes();
+    }
+    const sandboxScopes = getSandboxScopes();
+    const productionScopes = getProductionScopes();
+    const productionWithoutEdelivery = productionScopes.filter((scope) => scope !== 'https://api.ebay.com/oauth/scope/sell.edelivery');
+    const mergedScopes = new Set([...sandboxScopes, ...productionWithoutEdelivery]);
+    mergedScopes.add('https://api.ebay.com/oauth/api_scope/sell.edelivery');
+    mergedScopes.add('https://api.ebay.com/oauth/scope/sell.edelivery');
+    return Array.from(mergedScopes);
 }
 /**
  * Validate scopes against environment and return warnings for invalid scopes
@@ -172,14 +182,15 @@ 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({
+    // Build consent URL with auth2 endpoint (eBay's OAuth consent endpoint)
+    const consentDomain = env === 'production' ? 'https://auth2.ebay.com' : 'https://auth2.sandbox.ebay.com';
+    const consentParams = new URLSearchParams({
         client_id: clientId,
         redirect_uri: redirectUri,
         response_type: responseType,
@@ -188,7 +199,10 @@ export function getAuthUrl(clientIdOrEnvironment, redirectUri, environment, loca
         locale,
         ...(state ? { state } : {}),
     });
-    return `${authDomain}/oauth2/authorize?${params.toString()}`;
+    const consentUrl = `${consentDomain}/oauth2/consents?${consentParams.toString()}`;
+    // Build signin URL that redirects to consent
+    const signinDomain = env === 'production' ? 'https://signin.ebay.com' : 'https://signin.sandbox.ebay.com';
+    return `${signinDomain}/signin?ru=${encodeURIComponent(consentUrl)}&sgfl=oauth2&AppName=${encodeURIComponent(clientId)}`;
 }
 /**
  * Generate the OAuth authorization URL for user consent
@@ -227,34 +241,52 @@ environment, scopes, locale, state) {
     const ruParam = encodeURIComponent(`${authorizeEndpoint}?${params.toString()}`);
     return `${signinDomain}/signin?ru=${ruParam}&sgfl=oauth2_login&AppName=${clientId}`;
 }
+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/setup.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { dirname, join } from 'path';
+import { dirname, join, resolve } from 'path';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
 import { homedir, platform } from 'os';
 import axios from 'axios';
@@ -9,7 +9,9 @@ import { exec } from 'child_process';
 import { fileURLToPath } from 'url';
 import prompts from 'prompts';
 import { getDefaultScopes } from '../config/environment.js';
+import { checkForUpdates } from '../utils/version.js';
 config({ quiet: true });
+checkForUpdates();
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const PROJECT_ROOT = join(__dirname, '../..');
@@ -853,13 +855,25 @@ async function stepOAuth(state) {
         }
     }
     else if (tokenChoice.method === 'manual') {
-        const baseUrl = state.environment === 'production'
-            ? 'https://auth.ebay.com/oauth2/authorize'
-            : 'https://auth.sandbox.ebay.com/oauth2/authorize';
+        // Build the OAuth consent URL (auth2 endpoint)
+        const consentDomain = state.environment === 'production'
+            ? 'https://auth2.ebay.com'
+            : 'https://auth2.sandbox.ebay.com';
         // Get scopes from environment config
         const scopes = getDefaultScopes(state.environment);
-        const scopeParam = encodeURIComponent(scopes.join(' '));
-        const authUrl = `${baseUrl}?client_id=${encodeURIComponent(state.config.EBAY_CLIENT_ID)}&redirect_uri=${encodeURIComponent(state.config.EBAY_REDIRECT_URI)}&response_type=code&scope=${scopeParam}`;
+        // Build the consent URL parameters
+        const consentParams = new URLSearchParams({
+            client_id: state.config.EBAY_CLIENT_ID,
+            redirect_uri: state.config.EBAY_REDIRECT_URI,
+            response_type: 'code',
+            scope: scopes.join(' '),
+        });
+        const consentUrl = `${consentDomain}/oauth2/consents?${consentParams.toString()}`;
+        // Build the signin URL that redirects to consent
+        const signinDomain = state.environment === 'production'
+            ? 'https://signin.ebay.com'
+            : 'https://signin.sandbox.ebay.com';
+        const authUrl = `${signinDomain}/signin?ru=${encodeURIComponent(consentUrl)}&sgfl=oauth2&AppName=${encodeURIComponent(state.config.EBAY_CLIENT_ID)}`;
         console.log('\n  ' + ui.bold('OAuth Authorization URL:'));
         console.log(ui.dim('  ' + '─'.repeat(56)));
         console.log(`  ${ui.info(authUrl)}`);
@@ -1275,7 +1289,14 @@ process.on('SIGINT', () => {
     console.log(ui.warning('\n\n  Setup interrupted.\n'));
     process.exit(0);
 });
-main().catch((error) => {
-    console.error(ui.error('\n  Setup failed:'), error);
-    process.exit(1);
-});
+export async function runSetup() {
+    await main();
+}
+const entryPath = process.argv[1] ? resolve(process.argv[1]) : undefined;
+const modulePath = resolve(fileURLToPath(import.meta.url));
+if (entryPath && modulePath === entryPath) {
+    runSetup().catch((error) => {
+        console.error(ui.error('\n  Setup failed:'), error);
+        process.exit(1);
+    });
+}

package/build/scripts/update-api-status-doc.js

@@ -0,0 +1,44 @@
+/**
+ * Fetches the eBay API Status RSS feed and writes the latest items to docs/API_STATUS.md.
+ * Used by the GitHub Action to keep an in-repo snapshot. Run with: npx tsx src/scripts/update-api-status-doc.ts
+ */
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getApiStatusFeed } from '../utils/api-status-feed.js';
+const DEFAULT_LIMIT = 15;
+const OUT_PATH = join(process.cwd(), 'docs', 'API_STATUS.md');
+function escapeCell(s) {
+    return s.replace(/\|/g, '\\|').replace(/\n/g, ' ');
+}
+function buildMarkdown(items) {
+    const lines = [
+        '# eBay API Status (latest)',
+        '',
+        'Auto-updated snapshot from the [eBay API Status RSS feed](https://developer.ebay.com/rss/api-status).',
+        'Full list: [developer.ebay.com/support/api-status](https://developer.ebay.com/support/api-status).',
+        '',
+        `*Last updated: ${new Date().toISOString()}*`,
+        '',
+        '| Title | API | Site | Status | Last updated | Link |',
+        '|-------|-----|------|--------|--------------|------|',
+    ];
+    for (const item of items) {
+        const link = item.link ? `[Details](${item.link})` : '';
+        lines.push(`| ${escapeCell(item.title)} | ${escapeCell(item.api)} | ${escapeCell(item.site)} | ${escapeCell(item.status)} | ${escapeCell(item.lastUpdated)} | ${link} |`);
+    }
+    lines.push('', '---', '', '*Generated by [ebay-mcp](https://github.com/YosefHayim/ebay-mcp) API status sync.*');
+    return lines.join('\n');
+}
+async function main() {
+    const { items, error } = await getApiStatusFeed({ limit: DEFAULT_LIMIT });
+    if (error && items.length === 0) {
+        throw new Error(`Failed to fetch API status feed: ${error}`);
+    }
+    const markdown = buildMarkdown(items);
+    writeFileSync(OUT_PATH, markdown, 'utf8');
+    console.log(`Wrote ${items.length} items to ${OUT_PATH}`);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exitCode = 1;
+});

package/build/server-http.js

@@ -12,6 +12,8 @@ import express from 'express';
 import helmet from 'helmet';
 import cors from 'cors';
 import { randomUUID } from 'crypto';
+import { dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
@@ -21,6 +23,7 @@ import { getToolDefinitions, executeTool } from './tools/index.js';
 import { TokenVerifier } from './auth/token-verifier.js';
 import { createBearerAuthMiddleware } from './auth/oauth-middleware.js';
 import { createMetadataRouter, getProtectedResourceMetadataUrl } from './auth/oauth-metadata.js';
+import { getVersion } from './utils/version.js';
 // Configuration from environment
 const CONFIG = {
     // Server settings
@@ -62,6 +65,9 @@ function getAuthServerMetadataUrl() {
  */
 async function createApp() {
     const app = express();
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const projectRoot = join(__dirname, '..');
     // Enable CORS
     app.use(cors({
         // TODO: Restrict origin to known clients in production
@@ -84,6 +90,9 @@ async function createApp() {
     });
     // Server URL
     const serverUrl = `http://${CONFIG.host}:${CONFIG.port}`;
+    const iconBaseUrl = `${serverUrl}/icons`;
+    // Static assets (icons)
+    app.use('/icons', express.static(join(projectRoot, 'public', 'icons')));
     // Get eBay configuration for metadata
     const ebayConfig = getEbayConfig();
     // Add OAuth metadata endpoints
@@ -140,47 +149,55 @@ async function createApp() {
     /**
      * Create a new MCP server instance
      */
-    function createMcpServer() {
+    async function createMcpServer() {
         const ebayConfig = getEbayConfig();
         const api = new EbaySellerApi(ebayConfig);
+        try {
+            await api.initialize();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`Failed to initialize eBay API client: ${message}`);
+            throw error;
+        }
         const server = new McpServer({
             name: 'ebay-mcp',
-            version: '1.4.0',
+            version: getVersion(),
             title: 'eBay API MCP Server',
-            websiteUrl: 'https://coming-soon.com',
+            websiteUrl: 'https://github.com/YosefHayim/ebay-mcp',
             icons: [
                 {
-                    src: './icons/16x16.png',
+                    src: `${iconBaseUrl}/16x16.png`,
                     mimeType: 'image/png',
                     sizes: ['16x16'],
                 },
                 {
-                    src: './icons/32x32.png',
+                    src: `${iconBaseUrl}/32x32.png`,
                     mimeType: 'image/png',
                     sizes: ['32x32'],
                 },
                 {
-                    src: './icons/48x48.png',
+                    src: `${iconBaseUrl}/48x48.png`,
                     mimeType: 'image/png',
                     sizes: ['48x48'],
                 },
                 {
-                    src: './icons/128x128.png',
+                    src: `${iconBaseUrl}/128x128.png`,
                     mimeType: 'image/png',
                     sizes: ['128x128'],
                 },
                 {
-                    src: './icons/256x256.png',
+                    src: `${iconBaseUrl}/256x256.png`,
                     mimeType: 'image/png',
                     sizes: ['256x256'],
                 },
                 {
-                    src: './icons/512x512.png',
+                    src: `${iconBaseUrl}/512x512.png`,
                     mimeType: 'image/png',
                     sizes: ['512x512'],
                 },
                 {
-                    src: './icons/1024x1024.png',
+                    src: `${iconBaseUrl}/1024x1024.png`,
                     mimeType: 'image/png',
                     sizes: ['1024x1024'],
                 },
@@ -246,7 +263,7 @@ async function createApp() {
                     console.log(`MCP session closed: ${transport.sessionId}`);
                 }
             };
-            const server = createMcpServer();
+            const server = await createMcpServer();
             await server.connect(transport);
         }
         else {
@@ -338,7 +355,7 @@ async function main() {
             }
             else {
                 console.log('Authorization is DISABLED');
-                console.log('Set OAUTH_ENABLED=true to enable OAuth protection');
+                console.log('Set OAUTH_ENABLED=true (or remove OAUTH_ENABLED=false) to enable OAuth protection');
             }
         });
         // Graceful shutdown
@@ -356,6 +373,8 @@ async function main() {
     }
 }
 // Start server if run directly
-if (import.meta.url === `file://${process.argv[1]}`) {
+const entryPath = process.argv[1] ? resolve(process.argv[1]) : undefined;
+const modulePath = resolve(fileURLToPath(import.meta.url));
+if (entryPath && modulePath === entryPath) {
     await main();
 }

package/build/tools/definitions/developer.js

@@ -1,5 +1,48 @@
 import { z } from 'zod';
 export const developerTools = [
+    {
+        name: 'ebay_get_api_status',
+        description: 'Get the latest eBay API status and incidents from the official RSS feed. Returns recent issues, fixes, and outages for eBay APIs (e.g. Trading API, Inventory API, Sandbox). Use when the user asks about API status, outages, or fixes.',
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe('Maximum number of items to return (default 20)'),
+            status: z
+                .enum(['Resolved', 'Unresolved'])
+                .optional()
+                .describe('Filter by status: Resolved or Unresolved'),
+            api: z
+                .string()
+                .optional()
+                .describe('Filter by API name (e.g. "Trading API", "Inventory API", "Sandbox")'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                items: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            title: { type: 'string' },
+                            summary: { type: 'string' },
+                            link: { type: 'string' },
+                            api: { type: 'string' },
+                            site: { type: 'string' },
+                            status: { type: 'string' },
+                            lastUpdated: { type: 'string' },
+                        },
+                    },
+                },
+                error: { type: 'string' },
+            },
+            description: 'Latest API status items from eBay developer feed',
+        },
+    },
     {
         name: 'ebay_get_rate_limits',
         description: 'Get application rate limits for eBay APIs. Returns call quota, remaining calls, and time until reset for each API resource.',

package/build/tools/index.js

@@ -1,5 +1,7 @@
 import { getOAuthAuthorizationUrl, validateScopes } from '../config/environment.js';
 import { accountTools, analyticsTools, communicationTools, developerTools, fulfillmentTools, inventoryTools, marketingTools, metadataTools, otherApiTools, taxonomyTools, tokenManagementTools, } from '../tools/definitions/index.js';
+import { chatGptTools } from '../tools/tool-definitions.js';
+import { getApiStatusFeed } from '../utils/api-status-feed.js';
 import { convertToTimestamp, validateTokenExpiry } from '../utils/date-converter.js';
 // Import Zod schemas for input validation
 import { getAwaitingFeedbackSchema, getFeedbackRatingSummarySchema, getFeedbackSchema, leaveFeedbackForBuyerSchema, respondToFeedbackSchema, } from '../utils/communication/feedback.js';
@@ -10,7 +12,9 @@ import { createDestinationSchema, createSubscriptionFilterSchema, createSubscrip
  * Get all tool definitions for the MCP server
  */
 export function getToolDefinitions() {
+    const chatConnectorTools = chatGptTools.filter((tool) => tool.name === 'search' || tool.name === 'fetch');
     return [
+        ...chatConnectorTools,
         ...tokenManagementTools,
         ...accountTools,
         ...inventoryTools,
@@ -33,14 +37,42 @@ export async function executeTool(api, toolName, args) {
         case 'search': {
             // For this example, we'll treat the query as a search for inventory items.
             // A more robust implementation might search across different types of content.
-            const response = await api.inventory.getInventoryItems(args.limit ?? 10);
-            const results = response.inventoryItems?.map((item, index) => ({
-                id: `item-${index}`,
+            const requestedLimitRaw = args.limit;
+            const limit = typeof requestedLimitRaw === 'number' && Number.isFinite(requestedLimitRaw)
+                ? Math.max(Math.floor(requestedLimitRaw), 1)
+                : 10;
+            const query = args.query?.toLowerCase().trim();
+            const pageSize = query ? Math.min(Math.max(limit, 50), 200) : limit;
+            const matches = [];
+            let offset = 0;
+            while (matches.length < limit) {
+                const response = await api.inventory.getInventoryItems(pageSize, offset);
+                const pageItems = response.inventoryItems ?? [];
+                if (pageItems.length === 0) {
+                    break;
+                }
+                // Filter to only include items with valid SKUs (required for getInventoryItem calls)
+                const itemsWithSku = pageItems.filter((item) => typeof item.sku === 'string' && item.sku.trim() !== '');
+                const filtered = query
+                    ? itemsWithSku.filter((item) => (item.product?.title ?? '').toLowerCase().includes(query))
+                    : itemsWithSku;
+                matches.push(...filtered);
+                offset += pageSize;
+                const total = response.total;
+                if (typeof total === 'number' && offset >= total) {
+                    break;
+                }
+                if (!query || pageItems.length < pageSize) {
+                    break;
+                }
+            }
+            const results = matches.slice(0, limit).map((item) => ({
+                id: item.sku,
                 title: item.product?.title ?? 'No Title',
                 // The URL should be a canonical link to the item, which we don't have here.
                 // We'll use a placeholder.
                 url: `https://www.ebay.com/`, // Placeholder URL
-            })) ?? [];
+            }));
             // Format the response as required by the ChatGPT connector spec.
             return {
                 content: [
@@ -207,7 +239,7 @@ export async function executeTool(api, toolName, args) {
                     refreshExpiry = convertToTimestamp(refreshTokenExpiry);
                 }
                 // Set tokens (will use defaults if expiry times not provided)
-                await api.setUserTokens(accessToken, refreshToken);
+                await api.setUserTokens(accessToken, refreshToken, accessExpiry, refreshExpiry);
                 // If autoRefresh is enabled, attempt to get a fresh access token
                 // (The OAuth client will handle refresh internally if needed)
                 if (autoRefresh) {
@@ -1124,6 +1156,15 @@ export async function executeTool(api, toolName, args) {
                     },
                 ],
             };
+        // Developer API - API Status (public RSS feed)
+        case 'ebay_get_api_status': {
+            const result = await getApiStatusFeed({
+                limit: args.limit,
+                status: args.status,
+                api: args.api,
+            });
+            return { items: result.items, ...(result.error && { error: result.error }) };
+        }
         // Developer API - Rate Limits
         case 'ebay_get_rate_limits':
             return await api.developer.getRateLimits(args.apiContext, args.apiName);

package/build/utils/api-status-feed.js

@@ -0,0 +1,85 @@
+/**
+ * Fetches and parses the eBay API Status RSS feed (public, no auth).
+ * Used by the ebay_get_api_status MCP tool and optionally by the docs sync script.
+ */
+import { XMLParser } from 'fast-xml-parser';
+import axios from 'axios';
+const RSS_URL = 'https://developer.ebay.com/rss/api-status';
+function stripHtml(html) {
+    return html
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function normalizeString(value) {
+    if (value == null)
+        return '';
+    if (typeof value === 'string')
+        return value.trim();
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value).trim();
+    return '';
+}
+function parseItem(raw) {
+    const summary = normalizeString(raw.summary) ||
+        stripHtml(normalizeString(raw.description)).slice(0, 300) ||
+        '';
+    return {
+        title: normalizeString(raw.title) || 'Untitled',
+        summary: summary || normalizeString(raw.title),
+        link: normalizeString(raw.link) || '',
+        api: normalizeString(raw.api) || '',
+        site: normalizeString(raw.site) || '',
+        status: normalizeString(raw.status) || '',
+        lastUpdated: normalizeString(raw.lastUpdated) || '',
+    };
+}
+function ensureArray(value) {
+    if (value == null)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+/**
+ * Fetches the eBay API Status RSS feed, parses it, and returns items
+ * optionally filtered by status and API name, limited to `limit` items.
+ */
+export async function getApiStatusFeed(options = {}) {
+    const { limit = 20, status: statusFilter, api: apiFilter } = options;
+    try {
+        const response = await axios.get(RSS_URL, {
+            timeout: 15_000,
+            responseType: 'text',
+            headers: { Accept: 'application/rss+xml, application/xml, text/xml' },
+        });
+        const xml = response.data;
+        const parser = new XMLParser({
+            ignoreAttributes: true,
+            trimValues: true,
+            parseTagValue: false,
+        });
+        const parsed = parser.parse(xml);
+        const channel = parsed?.rss?.channel;
+        if (!channel) {
+            return { items: [], error: 'RSS feed missing channel' };
+        }
+        const rawItems = ensureArray(channel.item);
+        let items = rawItems.map(parseItem);
+        if (statusFilter) {
+            items = items.filter((i) => i.status.toLowerCase() === statusFilter.toLowerCase());
+        }
+        if (apiFilter?.trim()) {
+            const needle = apiFilter.trim().toLowerCase();
+            items = items.filter((i) => i.api.toLowerCase().includes(needle));
+        }
+        items = items.slice(0, Math.min(limit, 50));
+        return { items };
+    }
+    catch (err) {
+        const message = axios.isAxiosError(err) && err.response?.status
+            ? `Feed unavailable (HTTP ${err.response.status})`
+            : err instanceof Error
+                ? err.message
+                : 'Failed to fetch API status feed';
+        return { items: [], error: message };
+    }
+}

package/build/utils/version.js

@@ -0,0 +1,56 @@
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import updateNotifier from 'update-notifier';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PACKAGE_JSON_PATH = join(__dirname, '../../package.json');
+let cachedPackageJson = null;
+export function getPackageJson() {
+    if (cachedPackageJson) {
+        return cachedPackageJson;
+    }
+    try {
+        const content = readFileSync(PACKAGE_JSON_PATH, 'utf-8');
+        cachedPackageJson = JSON.parse(content);
+        return cachedPackageJson;
+    }
+    catch {
+        return { name: 'ebay-mcp', version: '0.0.0' };
+    }
+}
+export function getVersion() {
+    return getPackageJson().version;
+}
+export function getPackageName() {
+    return getPackageJson().name;
+}
+const ONE_DAY_MS = 1000 * 60 * 60 * 24;
+export function checkForUpdates(options = {}) {
+    const pkg = getPackageJson();
+    const notifier = updateNotifier({
+        pkg,
+        updateCheckInterval: ONE_DAY_MS,
+    });
+    notifier.notify({
+        isGlobal: true,
+        defer: options.defer ?? false,
+        message: 'Update available {currentVersion} → {latestVersion}\n' + 'Run {updateCommand} to update',
+    });
+}
+export async function getUpdateInfo() {
+    const pkg = getPackageJson();
+    const notifier = updateNotifier({
+        pkg,
+        updateCheckInterval: 0,
+    });
+    await notifier.fetchInfo();
+    if (notifier.update && notifier.update.latest !== pkg.version) {
+        return {
+            current: pkg.version,
+            latest: notifier.update.latest,
+            name: pkg.name,
+        };
+    }
+    return undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ebay-mcp",
-  "version": "1.6.1",
+  "version": "1.7.1",
   "description": "Local MCP server for eBay APIs - provides access to eBay developer functionality through MCP (Model Context Protocol)",
   "type": "module",
   "main": "build/index.js",
@@ -42,6 +42,7 @@
     "build/**/*.js",
     "build/index.d.ts",
     "build/server-http.d.ts",
+    "public/icons/*.png",
     "README.md"
   ],
   "repository": {
@@ -59,10 +60,12 @@
     "cors": "^2.8.5",
     "dotenv": "^17.2.3",
     "express": "^5.1.0",
+    "fast-xml-parser": "^5.3.4",
     "helmet": "^8.1.0",
     "jose": "^6.1.2",
     "jsonwebtoken": "^9.0.2",
     "prompts": "^2.4.2",
+    "update-notifier": "^7.3.1",
     "winston": "^3.19.0",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.24.1"
@@ -75,6 +78,7 @@
     "@types/node": "^24.10.1",
     "@types/prompts": "^2.4.9",
     "@types/supertest": "^6.0.3",
+    "@types/update-notifier": "^6.0.8",
     "@vitest/coverage-v8": "^4.0.13",
     "@vitest/ui": "^4.0.8",
     "eslint": "^9.39.1",