ebay-mcp-remote-edition 4.3.1 → 4.4.0

package/build/api/browse/browse.js

@@ -0,0 +1,43 @@
+import { getBaseUrl } from '../../config/environment.js';
+/**
+ * Browse API - Search and browse eBay product catalog
+ * Based on: eBay Buy Browse API
+ * Base endpoint: /buy/browse/v1
+ */
+export class BrowseApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Search the eBay product catalog by query.
+     * Supports category filtering, sorting, and price filtering.
+     */
+    async searchProducts(query, options) {
+        const environment = this.client.getConfig().environment;
+        const browseUrl = new URL('/buy/browse/v1/item_summary/search', getBaseUrl(environment)).toString();
+        const params = { q: query };
+        if (options?.categoryId)
+            params.category_ids = options.categoryId;
+        if (options?.limit)
+            params.limit = options.limit;
+        if (options?.sort)
+            params.sort = options.sort;
+        if (options?.filter)
+            params.filter = options.filter;
+        if (options?.aspectFilter)
+            params.aspect_filter = options.aspectFilter;
+        return await this.client.getWithFullUrl(browseUrl, params);
+    }
+    /**
+     * Get listing/product suggestions based on search query.
+     * Returns relevant item summaries with pricing and shipping info.
+     */
+    async getSuggestions(query, options) {
+        return await this.searchProducts(query, {
+            marketplaceId: options?.marketplaceId,
+            limit: options?.limit ?? 20,
+            sort: 'bestMatch',
+        });
+    }
+}

package/build/api/client-trading.js

@@ -49,7 +49,7 @@ export class TradingApiClient {
      * Handles nested objects like PrimaryCategory, ShippingDetails, ReturnPolicy,
      * PicturesDetails, and ItemSpecifics that require special XML structure.
      */
-    transformItemForXML(item) {
+    transformItemForXML(item, options = { ensureCountry: true }) {
         const transformed = {};
         for (const [key, value] of Object.entries(item)) {
             if (value === undefined || value === null)
@@ -117,6 +117,13 @@ export class TradingApiClient {
                 transformed.Currency = 'USD';
             }
         }
+        // Ensure Country is present for full listing creation/publish transforms.
+        // ReviseFixedPriceItem may update only a subset of fields; injecting a default Country
+        // can accidentally attempt to change an active listing's country and eBay rejects it as
+        // "Input data is invalid." Skip this default for partial revise payloads.
+        if (options.ensureCountry !== false && !transformed.Country) {
+            transformed.Country = 'USA';
+        }
         return transformed;
     }
     /**
@@ -124,13 +131,14 @@ export class TradingApiClient {
      * eBay Trading API expects: <StartPrice currencyID="USD">34.99</StartPrice>
      */
     transformPrice(price) {
-        if (typeof price === 'string') {
-            return price;
+        if (typeof price === 'string' || typeof price === 'number') {
+            return String(price);
         }
+        const currencyID = price.currencyID ?? price.currency;
         // Use fast-xml-parser attribute convention: @_<attrName> for attributes, #text for content
         return {
             '#text': String(price.value),
-            ...(price.currencyID && { '@_currencyID': price.currencyID }),
+            ...(currencyID && { '@_currencyID': currencyID }),
         };
     }
     /**
@@ -264,7 +272,7 @@ export class TradingApiClient {
         // Transform Item field for proper XML serialization
         const transformedParams = { ...params };
         if (transformedParams.Item && typeof transformedParams.Item === 'object') {
-            transformedParams.Item = this.transformItemForXML(transformedParams.Item);
+            transformedParams.Item = this.transformItemForXML(transformedParams.Item, { ensureCountry: callName !== 'ReviseFixedPriceItem' });
         }
         const xmlObj = {};
         xmlObj[requestTag] = {

package/build/api/index.js

@@ -19,6 +19,7 @@ import { EDeliveryApi } from '../api/other/edelivery.js';
 import { IdentityApi } from '../api/other/identity.js';
 import { TranslationApi } from '../api/other/translation.js';
 import { VeroApi } from '../api/other/vero.js';
+import { BrowseApi } from '../api/browse/browse.js';
 import { TradingApiClient } from '../api/client-trading.js';
 import { TradingApi } from '../api/trading/trading.js';
 export class EbaySellerApi {
@@ -44,6 +45,7 @@ export class EbaySellerApi {
     developer;
     media;
     trading;
+    browse;
     constructor(config, context) {
         this.client = new EbayApiClient(config, context);
         this.account = new AccountApi(this.client);
@@ -68,6 +70,7 @@ export class EbaySellerApi {
         this.media = new MediaApi(this.client);
         const tradingClient = new TradingApiClient(this.client);
         this.trading = new TradingApi(tradingClient);
+        this.browse = new BrowseApi(this.client);
     }
     async initialize() {
         await this.client.initialize();
@@ -110,3 +113,4 @@ export * from '../api/other/vero.js';
 export * from '../api/developer/developer.js';
 export * from '../api/trading/trading.js';
 export * from '../api/client-trading.js';
+export * from '../api/browse/browse.js';

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

@@ -360,17 +360,15 @@ export class InventoryApi {
         }
     }
     /**
-     * Get all offers
+     * Get offers for a specific SKU (sku is required)
      * @throws Error if parameters are invalid
      */
     async getOffers(sku, marketplaceId, limit) {
         const params = {};
-        if (sku !== undefined) {
-            if (typeof sku !== 'string') {
-                throw new Error('sku must be a string when provided');
-            }
-            params.sku = sku;
+        if (!sku || typeof sku !== 'string') {
+            throw new Error('sku is required for getOffers');
         }
+        params.sku = sku;
         if (marketplaceId !== undefined) {
             if (typeof marketplaceId !== 'string') {
                 throw new Error('marketplaceId must be a string when provided');

package/build/api/media/media.js

@@ -1,12 +1,13 @@
-import { getBaseUrl } from '../../config/environment.js';
 import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
 /**
  * Commerce Media API (v1_beta) - Upload and manage images via eBay Picture Services
  * Based on: https://developer.ebay.com/api-docs/commerce/media/resources/image/from_url/methods
  */
 export class MediaApi {
     client;
-    basePath = '/commerce/media/v1';
+    basePath = '/commerce/media/v1_beta';
     constructor(client) {
         this.client = client;
     }
@@ -15,14 +16,18 @@ export class MediaApi {
     }
     getMediaBaseUrl() {
         const env = this.client.getConfig().environment;
-        return getBaseUrl(env);
+        return env === 'production' ? 'https://apim.ebay.com' : 'https://apim.sandbox.ebay.com';
     }
     /**
      * Upload an image from a public URL to eBay Picture Services.
      *
-     * Steps:
-     * 1. POST /commerce/media/v1/image/from_url to create the image
-     * 2. GET /commerce/media/v1/image/{imageId} to retrieve the hosted URL
+     * Flow:
+     * 1. Download image from URL
+     * 2. Validate dimensions (min 500px, max 4800px)
+     * 3. Resize if needed (maintain aspect ratio)
+     * 4. Optimize and convert to JPEG
+     * 5. Upload to eBay via multipart/form-data
+     * 6. Return hosted URL
      *
      * Supported formats: JPG, GIF, PNG, BMP, TIFF, AVIF, HEIC, WEBP
      * Max file size: 10MB per image
@@ -38,15 +43,89 @@ export class MediaApi {
         const token = await this.getAccessToken();
         const baseUrl = this.getMediaBaseUrl();
         try {
-            // Step 1: Create image from URL
-            const body = { imageUrl };
+            // Try direct createImageFromUrl endpoint first (eBay downloads server-side)
+            // This avoids the need to download+process+upload ourselves
+            const requestBody = { imageUrl };
             if (description) {
-                Object.assign(body, { description });
+                requestBody.description = description;
             }
-            const createResponse = await axios.post(`${baseUrl}${this.basePath}/image/from_url`, body, {
+            const response = await axios.post(`${baseUrl}${this.basePath}/image/create_image_from_url`, requestBody, {
                 headers: {
                     Authorization: `Bearer ${token}`,
                     'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                },
+                timeout: 30000,
+            });
+            const data = response.data;
+            const imageId = data.id;
+            if (imageId) {
+                return await this.getImage(imageId);
+            }
+            // Fallback: if no image ID returned, try download+upload method
+            throw new Error('No image ID returned from createImageFromUrl endpoint');
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const status = error.response?.status;
+                const data = error.response?.data;
+                const message = typeof data === 'object' && data !== null && 'errors' in data
+                    ? data.errors?.[0]?.longMessage ||
+                        data.errors?.[0]?.message ||
+                        error.message
+                    : error.message;
+                throw new Error(`Failed to upload image from URL (status ${status}): ${message}`, {
+                    cause: error,
+                });
+            }
+            throw new Error(`Failed to upload image from URL: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
+        }
+    }
+    /**
+     * Upload an image from a local file to eBay Picture Services.
+     *
+     * Endpoint: POST /commerce/media/v1/image/create_image_from_file
+     * Content-Type: multipart/form-data
+     *
+     * Supported formats: JPG, GIF, PNG, BMP, TIFF, AVIF, HEIC, WEBP
+     * Max file size: 10MB per image
+     *
+     * @param filePath - Local file path of the image to upload
+     * @param description - Optional description for the image
+     * @returns Object with image ID and eBay-hosted image URL
+     */
+    async createImageFromFile(filePath, description) {
+        if (!filePath || typeof filePath !== 'string') {
+            throw new Error('filePath is required and must be a string');
+        }
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        const token = await this.getAccessToken();
+        const baseUrl = this.getMediaBaseUrl();
+        try {
+            const fileBuffer = fs.readFileSync(filePath);
+            // Build multipart/form-data body manually
+            const boundary = `----FormBoundary${Date.now()}`;
+            const fileName = path.basename(filePath);
+            // Build the multipart body
+            let body = '';
+            // File part
+            body += `--${boundary}\r\n`;
+            body += `Content-Disposition: form-data; name="imageFile"; filename="${fileName}"\r\n`;
+            body += `Content-Type: application/octet-stream\r\n\r\n`;
+            // Description part (optional)
+            if (description) {
+                body += `--${boundary}\r\n`;
+                body += `Content-Disposition: form-data; name="description"\r\n\r\n`;
+                body += `${description}\r\n`;
+            }
+            body += `--${boundary}--\r\n`;
+            const multipartBody = Buffer.concat([Buffer.from(body, 'utf-8'), Buffer.from(fileBuffer)]);
+            const createResponse = await axios.post(`${baseUrl}${this.basePath}/image/create_image_from_file`, multipartBody, {
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    'Content-Type': `multipart/form-data; boundary=${boundary}`,
                     Prefer: 'return=representation',
                 },
                 timeout: 30000,
@@ -59,7 +138,7 @@ export class MediaApi {
             if (!imageId) {
                 throw new Error('No image ID returned from create endpoint');
             }
-            // Step 2: Fetch image details to get the eBay-hosted URL
+            // Fetch image details to get the eBay-hosted URL
             return await this.getImage(imageId);
         }
         catch (error) {
@@ -71,12 +150,53 @@ export class MediaApi {
                         data.errors?.[0]?.message ||
                         error.message
                     : error.message;
-                throw new Error(`Failed to upload image from URL (status ${status}): ${message}`, {
+                throw new Error(`Failed to upload image from file (status ${status}): ${message}`, {
                     cause: error,
                 });
             }
-            throw new Error(`Failed to upload image from URL: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
+            throw new Error(`Failed to upload image from file: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
+        }
+    }
+    /**
+     * Upload a processed image buffer to eBay Picture Services.
+     *
+     * @param buffer - Processed image buffer
+     * @param metadata - Image metadata
+     * @param token - OAuth access token
+     * @param baseUrl - Media API base URL
+     * @param description - Optional description
+     * @returns Object with image ID and eBay-hosted image URL
+     */
+    async uploadProcessedImage(buffer, metadata, token, baseUrl, description) {
+        // Build multipart/form-data body
+        const boundary = `----FormBoundary${Date.now()}`;
+        const fileName = `image_${Date.now()}.jpg`;
+        let body = `--${boundary}\r\n`;
+        body += `Content-Disposition: form-data; name="imageFile"; filename="${fileName}"\r\n`;
+        body += `Content-Type: image/jpeg\r\n\r\n`;
+        if (description) {
+            body += `--${boundary}\r\n`;
+            body += `Content-Disposition: form-data; name="description"\r\n\r\n`;
+            body += `${description}\r\n`;
+        }
+        body += `--${boundary}--\r\n`;
+        const multipartBody = Buffer.concat([Buffer.from(body, 'utf-8'), buffer]);
+        const createResponse = await axios.post(`${baseUrl}${this.basePath}/image/create_image_from_file`, multipartBody, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': `multipart/form-data; boundary=${boundary}`,
+                Prefer: 'return=representation',
+            },
+            timeout: 30000,
+        });
+        const responseData = createResponse.data;
+        const imageId = typeof responseData.id === 'string'
+            ? responseData.id
+            : createResponse.headers.location?.split('/').pop();
+        if (!imageId) {
+            throw new Error('No image ID returned from create endpoint');
         }
+        return await this.getImage(imageId);
     }
     /**
      * Get image details including the eBay-hosted URL.

package/build/api/trading/trading.js

@@ -3,6 +3,14 @@ export class TradingApi {
     constructor(client) {
         this.client = client;
     }
+    /**
+     * Transform an item for Trading API XML serialization.
+     * Ensures required fields like Currency and Country are always present.
+     * Used by publish_offer flow to pre-transform inventory items before publishing.
+     */
+    transformItemForXML(item) {
+        return this.client.transformItemForXML(item);
+    }
     async getActiveListings(page = 1, entriesPerPage = 50) {
         const result = await this.client.execute('GetMyeBaySelling', {
             ActiveList: {

package/build/auth/oauth.js

@@ -46,6 +46,7 @@ export class EbayOAuthClient {
                     clientId: this.config.clientId,
                     clientSecret: this.config.clientSecret,
                     redirectUri: this.config.redirectUri,
+                    ruName: this.config.ruName,
                     userAccessToken: tokenData.access_token,
                     userRefreshToken: tokenData.refresh_token || envRefreshToken,
                     tokenType: tokenData.token_type,
@@ -99,6 +100,7 @@ export class EbayOAuthClient {
             clientId: this.config.clientId,
             clientSecret: this.config.clientSecret,
             redirectUri: this.config.redirectUri,
+            ruName: this.config.ruName,
             userAccessToken: accessToken,
             userRefreshToken: refreshToken,
             tokenType: 'Bearer',
@@ -128,8 +130,9 @@ export class EbayOAuthClient {
         return this.appAccessToken;
     }
     async exchangeCodeForToken(code) {
-        if (!this.config.redirectUri) {
-            throw new Error('Redirect URI is required for authorization code exchange');
+        const redirectUriForExchange = this.config.ruName || this.config.redirectUri;
+        if (!redirectUriForExchange) {
+            throw new Error('RuName (EBAY_RUNAME) or redirectUri is required for authorization code exchange');
         }
         const tokenUrl = this.getTokenEndpoint();
         const credentials = Buffer.from(`${this.config.clientId}:${this.config.clientSecret}`).toString('base64');
@@ -137,7 +140,7 @@ export class EbayOAuthClient {
             const response = await axios.post(tokenUrl, new URLSearchParams({
                 grant_type: 'authorization_code',
                 code,
-                redirect_uri: this.config.redirectUri,
+                redirect_uri: redirectUriForExchange,
             }).toString(), {
                 headers: {
                     'Content-Type': 'application/x-www-form-urlencoded',
@@ -150,6 +153,7 @@ export class EbayOAuthClient {
                 clientId: this.config.clientId,
                 clientSecret: this.config.clientSecret,
                 redirectUri: this.config.redirectUri,
+                ruName: this.config.ruName,
                 userAccessToken: tokenData.access_token,
                 userRefreshToken: tokenData.refresh_token,
                 tokenType: tokenData.token_type,
@@ -195,6 +199,7 @@ export class EbayOAuthClient {
             clientId: this.config.clientId,
             clientSecret: this.config.clientSecret,
             redirectUri: this.config.redirectUri,
+            ruName: this.config.ruName,
             userAccessToken: tokenData.access_token,
             userRefreshToken: tokenData.refresh_token || this.userTokens.userRefreshToken,
             tokenType: tokenData.token_type,
@@ -215,6 +220,7 @@ export class EbayOAuthClient {
             hasRefreshToken: !!this.userTokens?.userRefreshToken,
             hasAccessToken: !!this.userTokens?.userAccessToken,
             hasRedirectUri: !!this.config.redirectUri,
+            hasRuName: !!this.config.ruName,
             ...(this.userTokens?.userRefreshTokenExpiry
                 ? { refreshTokenExpiry: this.userTokens.userRefreshTokenExpiry }
                 : {}),

package/build/config/environment.js

@@ -268,19 +268,18 @@ export function getEbayConfig(environmentOverride) {
         : process.env.EBAY_SANDBOX_CLIENT_SECRET || process.env.EBAY_CLIENT_SECRET || '';
     // Preferred var is EBAY_RUNAME (clearer naming — it IS the RuName, not a URL).
     // EBAY_REDIRECT_URI is kept for backward compatibility.
+    // RuName is for token exchange; redirectUri is for browser OAuth flow. Separate purposes.
+    const fallbackRuName = environment === 'production'
+        ? process.env.EBAY_PRODUCTION_RUNAME || process.env.EBAY_RUNAME || ''
+        : process.env.EBAY_SANDBOX_RUNAME || process.env.EBAY_RUNAME || '';
     const fallbackRedirectUri = environment === 'production'
-        ? process.env.EBAY_PRODUCTION_RUNAME ||
-            process.env.EBAY_PRODUCTION_REDIRECT_URI ||
-            process.env.EBAY_RUNAME ||
-            process.env.EBAY_REDIRECT_URI
-        : process.env.EBAY_SANDBOX_RUNAME ||
-            process.env.EBAY_SANDBOX_REDIRECT_URI ||
-            process.env.EBAY_RUNAME ||
-            process.env.EBAY_REDIRECT_URI;
+        ? process.env.EBAY_PRODUCTION_REDIRECT_URI || process.env.EBAY_REDIRECT_URI || ''
+        : process.env.EBAY_SANDBOX_REDIRECT_URI || process.env.EBAY_REDIRECT_URI || '';
     return {
         clientId: secretConfig?.clientId || fallbackClientId,
         clientSecret: secretConfig?.clientSecret || fallbackClientSecret,
-        redirectUri: secretConfig?.redirectUri || fallbackRedirectUri,
+        redirectUri: secretConfig?.redirectUri || fallbackRedirectUri || undefined,
+        ruName: secretConfig?.ruName || fallbackRuName || undefined,
         marketplaceId: (process.env.EBAY_MARKETPLACE_ID ?? '').trim() || 'EBAY_US',
         contentLanguage: (process.env.EBAY_CONTENT_LANGUAGE ?? '').trim() || 'en-US',
         environment,

package/build/server-http.js

@@ -745,7 +745,7 @@ function mountEnvRouter(hardcodedEnv, serverUrl, iconBaseUrl) {
             serverLogger.info(`[${prefix || 'root'}/authorize] Credential check`, {
                 environment,
                 envSource,
-                ruName: ebayConfig.redirectUri,
+                ruName: ebayConfig.ruName || ebayConfig.redirectUri,
                 ruNameDetectedEnv: credCheck.detectedEnv,
                 credentialValid: credCheck.valid,
             });
@@ -770,7 +770,7 @@ function mountEnvRouter(hardcodedEnv, serverUrl, iconBaseUrl) {
             serverLogger.info(`[${prefix || 'root'}/authorize] Redirecting to eBay OAuth`, {
                 state: stateRecord.state,
                 environment,
-                ruName: ebayConfig.redirectUri,
+                ruName: ebayConfig.ruName || ebayConfig.redirectUri,
                 expectedCallbackUrl: getExpectedOAuthCallbackUrl(serverUrl),
             });
             res.redirect(oauthUrl);
@@ -874,7 +874,7 @@ function mountEnvRouter(hardcodedEnv, serverUrl, iconBaseUrl) {
             serverLogger.info(`[${prefix || 'root'}/oauth/start] Redirecting to eBay OAuth`, {
                 state: stateRecord.state,
                 environment,
-                ruName: ebayConfig.redirectUri,
+                ruName: ebayConfig.ruName || ebayConfig.redirectUri,
                 expectedCallbackUrl: getExpectedOAuthCallbackUrl(serverUrl),
                 returnTo,
             });
@@ -1132,7 +1132,7 @@ async function handleOAuthCallback(req, res, serverUrl) {
             environment,
             tokenBaseUrl: getBaseUrl(environment),
             clientIdPrefix: ebayConfig.clientId ? `${ebayConfig.clientId.slice(0, 12)}...` : '(missing)',
-            ruName: ebayConfig.redirectUri ?? '(missing)',
+            ruName: (ebayConfig.ruName || ebayConfig.redirectUri) ?? '(missing)',
         });
         const userId = randomUUID();
         const api = await createUserScopedApi(userId, environment);

package/build/tools/definitions/browse.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+export const browseTools = [
+    {
+        name: 'ebay_get_suggestions',
+        description: 'Get listing/product suggestions based on search query. Returns relevant item summaries with pricing and shipping info from the eBay Browse API.',
+        inputSchema: {
+            query: z.string().describe('Search query for product suggestions'),
+            marketplaceId: z.string().default('EBAY_US').describe('Marketplace ID (default: EBAY_US)'),
+            limit: z.number().default(20).describe('Number of suggestions to return (default: 20)'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                success: { type: 'boolean' },
+                data: { type: 'object' },
+            },
+        },
+        annotations: {
+            title: 'Get Suggestions',
+            readOnlyHint: true,
+        },
+        _meta: {
+            category: 'browse',
+            version: '1.0.0',
+        },
+    },
+    {
+        name: 'ebay_search_products',
+        description: 'Search the eBay product catalog by query. Supports category filtering, sorting, and price filtering. Uses the eBay Browse API.',
+        inputSchema: {
+            query: z.string().describe('Search query for products'),
+            marketplaceId: z.string().describe('Marketplace ID (e.g., EBAY_US)'),
+            categoryId: z.string().optional().describe('Filter by category ID'),
+            limit: z.number().default(20).describe('Results to return (1-200, default: 20)'),
+            sort: z
+                .enum(['bestMatch', 'newlyListed'])
+                .optional()
+                .describe('Sort order (default: bestMatch)'),
+            filter: z
+                .string()
+                .optional()
+                .describe('Filter expression (e.g., price:[300..800],priceCurrency:USD)'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                success: { type: 'boolean' },
+                data: { type: 'object' },
+            },
+        },
+        annotations: {
+            title: 'Search Products',
+            readOnlyHint: true,
+        },
+        _meta: {
+            category: 'browse',
+            version: '1.0.0',
+        },
+    },
+    {
+        name: 'ebay_get_item_specifics',
+        description: 'Get required and optional item specifics (aspects) for a given category. Use this to understand what fields are needed for listing in a category. This is an alias to ebay_get_item_aspects_for_category.',
+        inputSchema: {
+            categoryTreeId: z.string().describe('Category tree ID'),
+            categoryId: z.string().describe('Category ID'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                success: { type: 'boolean' },
+                data: { type: 'object' },
+            },
+        },
+        annotations: {
+            title: 'Get Item Specifics',
+            readOnlyHint: true,
+        },
+        _meta: {
+            category: 'browse',
+            version: '1.0.0',
+        },
+    },
+];

package/build/tools/definitions/index.js

@@ -18,12 +18,13 @@ import { marketingTools } from './marketing.js';
 import { analyticsTools } from './analytics.js';
 import { metadataTools } from './metadata.js';
 import { taxonomyTools } from './taxonomy.js';
+import { browseTools } from './browse.js';
 import { communicationTools } from './communication.js';
 import { otherApiTools } from './other.js';
 import { developerTools } from './developer.js';
 import { tradingTools } from './trading.js';
 // Export individual categories
-export { tokenManagementTools, accountTools, inventoryTools, fulfillmentTools, marketingTools, analyticsTools, metadataTools, taxonomyTools, communicationTools, otherApiTools, developerTools, tradingTools, };
+export { tokenManagementTools, accountTools, inventoryTools, fulfillmentTools, marketingTools, analyticsTools, metadataTools, taxonomyTools, browseTools, communicationTools, otherApiTools, developerTools, tradingTools, };
 // Export all tools as a single array
 export const allTools = [
     ...tokenManagementTools,
@@ -34,6 +35,7 @@ export const allTools = [
     ...analyticsTools,
     ...metadataTools,
     ...taxonomyTools,
+    ...browseTools,
     ...communicationTools,
     ...otherApiTools,
     ...developerTools,

package/build/tools/definitions/inventory.js

@@ -71,11 +71,73 @@ export const inventoryTools = [
             properties: {},
         },
     },
+    {
+        name: 'ebay_update_inventory_item',
+        description: 'Update an existing inventory item by SKU. Supports partial updates — only provide the fields you want to change. Fetches existing data, merges your updates, then saves back. Use this for price changes, quantity updates, title edits, etc.\n\nIf the SKU does not exist, returns an error. Create it first with ebay_create_inventory_item.',
+        inputSchema: {
+            sku: z.string().describe('The seller-defined SKU to update (must already exist)'),
+            availability: z
+                .object({
+                shipToLocationAvailability: z
+                    .object({
+                    quantity: z.number().describe('New quantity'),
+                })
+                    .optional(),
+            })
+                .optional()
+                .describe('Availability updates'),
+            product: z
+                .object({
+                title: z.string().optional().describe('New title (max 80 characters)'),
+                brand: z.string().optional().describe('Brand name'),
+                description: z.string().optional().describe('HTML description'),
+                imageUrls: z.array(z.string()).optional().describe('Array of image URLs'),
+                mpn: z.string().optional().describe('Manufacturer Part Number'),
+                aspects: z
+                    .record(z.string(), z.array(z.string()))
+                    .optional()
+                    .describe('Item aspects/attributes (e.g., Color, Size)'),
+            })
+                .optional()
+                .describe('Product data updates'),
+            condition: z
+                .enum([
+                'NEW',
+                'LIKE_NEW',
+                'NEW_OTHER',
+                'NEW_WITH_DEFECTS',
+                'USED_EXCELLENT',
+                'USED_VERY_GOOD',
+                'USED_GOOD',
+                'USED_ACCEPTABLE',
+                'FOR_PARTS_OR_NOT_WORKING',
+            ])
+                .optional()
+                .describe('Item condition'),
+            conditionDescription: z
+                .string()
+                .optional()
+                .describe('Condition description (for used items)'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                sku: { type: 'string' },
+                status: { type: 'string' },
+            },
+        },
+        annotations: {
+            title: 'Update Inventory Item',
+            readOnlyHint: false,
+        },
+    },
     {
         name: 'ebay_get_offers',
-        description: 'Get all offers for the seller',
+        description: 'Get offers for a specific SKU. Requires a valid SKU — eBay API returns error 25707 without one.',
         inputSchema: {
-            sku: z.string().optional().describe('Filter by SKU'),
+            sku: z
+                .string()
+                .describe('The seller-defined SKU (required — eBay API returns error 25707 without it)'),
             marketplaceId: z.nativeEnum(MarketplaceId).optional().describe('Filter by marketplace ID'),
             limit: z.number().optional().describe('Number of offers to return'),
         },