ebay-mcp 1.6.2 → 1.7.2

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/definitions/token-management.js

@@ -126,7 +126,7 @@ export const tokenManagementTools = [
             'IMPORTANT NOTES:\n' +
             '- Authorization codes expire in ~5 minutes - if you get "invalid grant" error, get a fresh code\n' +
             '- Codes can be URL-encoded (e.g., v%5E1.1%23...) - this tool automatically decodes them\n' +
-            '- Extract the code parameter from the redirect URL: https://auth2.ebay.com/...&code=YOUR_CODE&expires_in=299\n' +
+            '- Extract the code parameter from the redirect URL (your RuName Accept URL): https://your-redirect-uri?code=YOUR_CODE&expires_in=299\n' +
             '- Tokens are saved to .env file and will auto-refresh every 2 hours\n' +
             '- Refresh tokens last 18 months before requiring re-authorization\n\n' +
             'COMMON ERRORS:\n' +

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.2",
+  "version": "1.7.2",
   "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",