ebay-mcp-remote-edition 4.2.1 → 4.3.1

package/build/api/index.js

@@ -6,6 +6,7 @@ import { MessageApi } from '../api/communication/message.js';
 import { NegotiationApi } from '../api/communication/negotiation.js';
 import { NotificationApi } from '../api/communication/notification.js';
 import { DeveloperApi } from '../api/developer/developer.js';
+import { MediaApi } from '../api/media/media.js';
 import { InventoryApi } from '../api/listing-management/inventory.js';
 import { MetadataApi } from '../api/listing-metadata/metadata.js';
 import { TaxonomyApi } from '../api/listing-metadata/taxonomy.js';
@@ -41,6 +42,7 @@ export class EbaySellerApi {
     translation;
     edelivery;
     developer;
+    media;
     trading;
     constructor(config, context) {
         this.client = new EbayApiClient(config, context);
@@ -63,6 +65,7 @@ export class EbaySellerApi {
         this.translation = new TranslationApi(this.client);
         this.edelivery = new EDeliveryApi(this.client);
         this.developer = new DeveloperApi(this.client);
+        this.media = new MediaApi(this.client);
         const tradingClient = new TradingApiClient(this.client);
         this.trading = new TradingApi(tradingClient);
     }

package/build/api/media/media.js

@@ -0,0 +1,124 @@
+import { getBaseUrl } from '../../config/environment.js';
+import axios from 'axios';
+/**
+ * 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';
+    constructor(client) {
+        this.client = client;
+    }
+    async getAccessToken() {
+        return await this.client.getOAuthClient().getAccessToken();
+    }
+    getMediaBaseUrl() {
+        const env = this.client.getConfig().environment;
+        return getBaseUrl(env);
+    }
+    /**
+     * 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
+     *
+     * Supported formats: JPG, GIF, PNG, BMP, TIFF, AVIF, HEIC, WEBP
+     * Max file size: 10MB per image
+     *
+     * @param imageUrl - Public URL of the image to upload
+     * @param description - Optional description for the image
+     * @returns Object with image ID and eBay-hosted image URL
+     */
+    async createImageFromUrl(imageUrl, description) {
+        if (!imageUrl || typeof imageUrl !== 'string') {
+            throw new Error('imageUrl is required and must be a string');
+        }
+        const token = await this.getAccessToken();
+        const baseUrl = this.getMediaBaseUrl();
+        try {
+            // Step 1: Create image from URL
+            const body = { imageUrl };
+            if (description) {
+                Object.assign(body, { description });
+            }
+            const createResponse = await axios.post(`${baseUrl}${this.basePath}/image/from_url`, body, {
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    'Content-Type': 'application/json',
+                    Prefer: 'return=representation',
+                },
+                timeout: 30000,
+            });
+            // Extract image ID from response body or Location header
+            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');
+            }
+            // Step 2: Fetch image details to get the eBay-hosted URL
+            return await this.getImage(imageId);
+        }
+        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 });
+        }
+    }
+    /**
+     * Get image details including the eBay-hosted URL.
+     *
+     * @param imageId - The image ID returned from createImageFromUrl
+     * @returns Image details including hosted URL
+     */
+    async getImage(imageId) {
+        if (!imageId || typeof imageId !== 'string') {
+            throw new Error('imageId is required and must be a string');
+        }
+        const token = await this.getAccessToken();
+        const baseUrl = this.getMediaBaseUrl();
+        try {
+            const response = await axios.get(`${baseUrl}${this.basePath}/image/${imageId}`, {
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    Accept: 'application/json',
+                },
+                timeout: 30000,
+            });
+            const data = response.data;
+            return {
+                id: data.id,
+                imageUrl: data.imageUrl,
+                description: typeof data.description === 'string' ? data.description : undefined,
+            };
+        }
+        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 get image details (status ${status}): ${message}`, {
+                    cause: error,
+                });
+            }
+            throw new Error(`Failed to get image details: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
+        }
+    }
+}

package/build/api/trading/trading.js

@@ -51,7 +51,8 @@ export class TradingApi {
         return items?.[0] || result;
     }
     async createListing(item) {
-        return await this.client.execute('AddFixedPriceItem', { Item: item });
+        const transformed = this.client.transformItemForXML(item);
+        return await this.client.execute('AddFixedPriceItem', { Item: transformed });
     }
     async reviseListing(itemId, fields) {
         if (!itemId)

package/build/tools/definitions/inventory.js

@@ -1,4 +1,4 @@
-import { MarketplaceId } from '../../types/ebay-enums.js';
+import { MarketplaceId, Condition } from '../../types/ebay-enums.js';
 import { z } from 'zod';
 import { zodToJsonSchema } from '../../utils/zod-compat.js';
 import { bulkInventoryItemRequestSchema, bulkMigrateRequestSchema, bulkOfferRequestSchema, bulkPriceQuantityRequestSchema, bulkPublishRequestSchema, inventoryItemGroupSchema, inventoryItemSchema, listingFeesRequestSchema, locationSchema, offerSchema, productCompatibilitySchema, } from '../schemas.js';
@@ -29,10 +29,31 @@ export const inventoryTools = [
     },
     {
         name: 'ebay_create_inventory_item',
-        description: 'Create or replace an inventory item.\n\nRequired OAuth Scope: sell.inventory\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory',
+        description: 'Create or replace an inventory item.\\n\\nRequired OAuth Scope: sell.inventory\\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.inventory',
         inputSchema: {
             sku: z.string().describe('The seller-defined SKU'),
-            inventoryItem: inventoryItemSchema.describe('Inventory item details'),
+            inventoryItem: inventoryItemSchema.describe('Inventory item details (availability, condition, etc.)'),
+            // Accept individual inventory fields as top-level fallback for LLMs that don't wrap in inventoryItem
+            availability: z
+                .any()
+                .optional()
+                .describe('[Fallback] Availability details if inventoryItem not provided'),
+            condition: z
+                .nativeEnum(Condition)
+                .optional()
+                .describe('[Fallback] Item condition if inventoryItem not provided'),
+            conditionDescription: z
+                .string()
+                .optional()
+                .describe('[Fallback] Condition description if inventoryItem not provided'),
+            product: z
+                .any()
+                .optional()
+                .describe('[Fallback] Product details if inventoryItem not provided'),
+            packageWeightAndSize: z
+                .any()
+                .optional()
+                .describe('[Fallback] Package weight/size if inventoryItem not provided'),
         },
         outputSchema: zodToJsonSchema(createInventoryItemOutputSchema, {
             name: 'CreateInventoryItemResponse',

package/build/tools/definitions/trading.js

@@ -150,4 +150,15 @@ export const tradingTools = [
         },
         annotations: { readOnlyHint: false },
     },
+    {
+        name: 'ebay_upload_images',
+        description: 'Upload images to eBay Picture Services using the Commerce Media API and get eBay-hosted image URLs for use in listings.\n\nUploads images from public URLs — eBay fetches and hosts them on their servers. The returned image URLs can be used in ebay_create_listing PicturesDetails.PictureURL array.\n\nSupports: JPG, GIF, PNG, BMP, TIFF, AVIF, HEIC, WEBP. Max 10MB per image.\n\nReturns a result for each uploaded image including the eBay-hosted URL and image ID.',
+        inputSchema: {
+            imageUrls: z
+                .array(z.string().describe('Public URL of the image to upload'))
+                .describe('Array of image URLs to upload (1 or more)'),
+            description: z.string().optional().describe('Optional description for the uploaded images'),
+        },
+        annotations: { readOnlyHint: false },
+    },
 ];

package/build/tools/index.js

@@ -8,6 +8,37 @@ import { getAwaitingFeedbackSchema, getFeedbackRatingSummarySchema, getFeedbackS
 import { bulkUpdateConversationSchema, getConversationSchema, getConversationsSchema, sendMessageSchema, updateConversationSchema, } from '../utils/communication/message.js';
 import { findEligibleItemsSchema, getOffersToBuyersSchema, sendOfferToInterestedBuyersSchema, } from '../utils/communication/negotiation.js';
 import { createDestinationSchema, createSubscriptionFilterSchema, createSubscriptionSchema, deleteDestinationSchema, deleteSubscriptionFilterSchema, deleteSubscriptionSchema, disableSubscriptionSchema, enableSubscriptionSchema, getConfigSchema, getDestinationSchema, getPublicKeySchema, getSubscriptionFilterSchema, getSubscriptionSchema, getSubscriptionsSchema, getTopicSchema, getTopicsSchema, testSubscriptionSchema, updateConfigSchema, updateDestinationSchema, updateSubscriptionSchema, } from '../utils/communication/notification.js';
+/**
+ * Normalize enum values that LLMs often send in wrong formats
+ * (lowercase, plural, hyphenated) to eBay API uppercase snake_case format
+ */
+function normalizeEnumValue(value) {
+    return value.toUpperCase().replace(/-/g, '_').replace(/S$/, ''); // Remove trailing S (e.g., "DAYS" -> "DAY")
+}
+/**
+ * Normalize time duration unit values
+ */
+function normalizeTimeUnit(value) {
+    const normalized = value.toUpperCase().replace(/-/g, '_');
+    const timeUnitMap = {
+        DAY: 'DAY',
+        DAYS: 'DAY',
+        BUSINESS_DAY: 'BUSINESS_DAY',
+        BUSINESS_DAYS: 'BUSINESS_DAY',
+        CALENDAR_DAY: 'CALENDAR_DAY',
+        HOUR: 'HOUR',
+        HOURS: 'HOUR',
+        MINUTE: 'MINUTE',
+        MINUTES: 'MINUTE',
+        SECOND: 'SECOND',
+        SECONDS: 'SECOND',
+        MONTH: 'MONTH',
+        MONTHS: 'MONTH',
+        YEAR: 'YEAR',
+        YEARS: 'YEAR',
+    };
+    return timeUnitMap[normalized] || normalized;
+}
 /**
  * Get all tool definitions for the MCP server
  */
@@ -414,8 +445,17 @@ export async function executeTool(api, toolName, args) {
         case 'ebay_get_return_policies':
             return await api.account.getReturnPolicies(args.marketplaceId);
         // Fulfillment Policy CRUD
-        case 'ebay_create_fulfillment_policy':
-            return await api.account.createFulfillmentPolicy(args.policy);
+        case 'ebay_create_fulfillment_policy': {
+            // Normalize handlingTime.unit to valid enum values (LLMs often send lowercase/plural)
+            const policy = args.policy;
+            if (policy?.handlingTime && typeof policy.handlingTime === 'object') {
+                const ht = policy.handlingTime;
+                if (typeof ht.unit === 'string') {
+                    ht.unit = normalizeTimeUnit(ht.unit);
+                }
+            }
+            return await api.account.createFulfillmentPolicy(policy);
+        }
         case 'ebay_get_fulfillment_policy':
             return await api.account.getFulfillmentPolicy(args.fulfillmentPolicyId);
         case 'ebay_get_fulfillment_policy_by_name':
@@ -495,8 +535,27 @@ export async function executeTool(api, toolName, args) {
             return await api.inventory.getInventoryItems(args.limit, args.offset);
         case 'ebay_get_inventory_item':
             return await api.inventory.getInventoryItem(args.sku);
-        case 'ebay_create_inventory_item':
-            return await api.inventory.createOrReplaceInventoryItem(args.sku, args.inventoryItem);
+        case 'ebay_create_inventory_item': {
+            // Handle both patterns: nested inventoryItem OR flat fields
+            let inventoryItemData = args.inventoryItem;
+            if (!inventoryItemData || typeof inventoryItemData !== 'object') {
+                // Merge fallback fields into inventoryItem
+                const fallbackFields = [
+                    'availability',
+                    'condition',
+                    'conditionDescription',
+                    'product',
+                    'packageWeightAndSize',
+                ];
+                inventoryItemData = {};
+                for (const field of fallbackFields) {
+                    if (args[field] !== undefined) {
+                        inventoryItemData[field] = args[field];
+                    }
+                }
+            }
+            return await api.inventory.createOrReplaceInventoryItem(args.sku, inventoryItemData);
+        }
         case 'ebay_delete_inventory_item':
             return await api.inventory.deleteInventoryItem(args.sku);
         // Bulk Operations
@@ -540,10 +599,20 @@ export async function executeTool(api, toolName, args) {
             return await api.inventory.getOffers(args.sku, args.marketplaceId, args.limit);
         case 'ebay_get_offer':
             return await api.inventory.getOffer(args.offerId);
-        case 'ebay_create_offer':
-            return await api.inventory.createOffer(args.offer);
-        case 'ebay_update_offer':
-            return await api.inventory.updateOffer(args.offerId, args.offer);
+        case 'ebay_create_offer': {
+            const offer = args.offer;
+            if (offer?.format) {
+                offer.format = normalizeEnumValue(offer.format);
+            }
+            return await api.inventory.createOffer(offer);
+        }
+        case 'ebay_update_offer': {
+            const offer = args.offer;
+            if (offer?.format) {
+                offer.format = normalizeEnumValue(offer.format);
+            }
+            return await api.inventory.updateOffer(args.offerId, offer);
+        }
         case 'ebay_delete_offer':
             return await api.inventory.deleteOffer(args.offerId);
         case 'ebay_publish_offer':
@@ -1235,6 +1304,29 @@ export async function executeTool(api, toolName, args) {
             return await api.trading.endListing(args.itemId, args.reason);
         case 'ebay_relist_item':
             return await api.trading.relistItem(args.itemId, args.modifications);
+        case 'ebay_upload_images': {
+            const imageUrls = args.imageUrls;
+            const description = args.description;
+            const results = [];
+            for (const imageUrl of imageUrls) {
+                try {
+                    const result = await api.media.createImageFromUrl(imageUrl, description);
+                    results.push({ success: true, id: result.id, imageUrl: result.imageUrl });
+                }
+                catch (e) {
+                    results.push({
+                        success: false,
+                        error: e instanceof Error ? e.message : String(e),
+                        sourceUrl: imageUrl,
+                    });
+                }
+            }
+            return {
+                uploaded: results.filter((r) => r.success).length,
+                failed: results.filter((r) => !r.success).length,
+                results,
+            };
+        }
         default:
             throw new Error(`Unknown tool: ${toolName}`);
     }

package/build/tools/schemas.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { TimeDurationUnit, RegionType, ShippingCostType, ShippingOptionType, DepositType, RefundMethod, ReturnMethod, ReturnShippingCostPayer, Condition, LengthUnit, WeightUnit, PricingVisibility, FormatType, LocationType, MerchantLocationStatus, DayOfWeek, ReasonForRefund, FundingModel, MessageReferenceType, FeedbackRating, ReportedItemType, } from '../types/ebay-enums.js';
+import { RegionType, ShippingCostType, ShippingOptionType, DepositType, RefundMethod, ReturnMethod, ReturnShippingCostPayer, Condition, LengthUnit, WeightUnit, PricingVisibility, FormatType, LocationType, MerchantLocationStatus, DayOfWeek, ReasonForRefund, FundingModel, MessageReferenceType, FeedbackRating, ReportedItemType, TimeDurationUnit, } from '../types/ebay-enums.js';
 /**
  * Reusable Zod schemas for eBay API tool input validation
  *
@@ -11,7 +11,9 @@ import { TimeDurationUnit, RegionType, ShippingCostType, ShippingOptionType, Dep
 // ============================================================================
 export const timeDurationSchema = z
     .object({
-    unit: z.nativeEnum(TimeDurationUnit),
+    unit: z
+        .nativeEnum(TimeDurationUnit)
+        .describe('Time unit: DAY, BUSINESS_DAY, CALENDAR_DAY, HOUR, MINUTE, SECOND, MONTH, YEAR'),
     value: z.number(),
 })
     .passthrough();
@@ -233,7 +235,7 @@ export const offerSchema = z
     .object({
     sku: z.string(),
     marketplaceId: z.string(),
-    format: z.nativeEnum(FormatType),
+    format: z.string().describe('Listing format: FIXED_PRICE (recommended) or AUCTION'),
     availableQuantity: z.number().optional(),
     categoryId: z.string().optional(),
     listingDescription: z.string().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ebay-mcp-remote-edition",
-  "version": "4.2.1",
+  "version": "4.3.1",
   "description": "Remote + Local MCP server for eBay APIs - provides access to eBay developer functionality through MCP (Model Context Protocol)",
   "type": "module",
   "main": "build/index.js",
@@ -69,21 +69,21 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
     "@upstash/redis": "^1.37.0",
-    "axios": "^1.14.0",
+    "axios": "^1.16.0",
     "chalk": "^5.6.2",
     "cors": "^2.8.6",
     "dotenv-stringify": "^3.0.1",
     "express": "^5.2.1",
-    "fast-xml-parser": "^5.5.10",
+    "fast-xml-parser": "^5.7.2",
     "flatted": "^3.4.2",
     "helmet": "^8.1.0",
-    "jose": "^6.2.2",
+    "jose": "^6.2.3",
     "jsonwebtoken": "^9.0.3",
     "playwright-core": "^1.59.1",
     "prompts": "^2.4.2",
     "update-notifier": "^7.3.1",
     "winston": "^3.19.0",
-    "zod": "^4.3.6",
+    "zod": "^4.4.3",
     "zod-to-json-schema": "^3.25.2"
   },
   "devDependencies": {
@@ -91,27 +91,27 @@
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/jsonwebtoken": "^9.0.10",
-    "@types/node": "^25.5.2",
+    "@types/node": "^25.6.0",
     "@types/prompts": "^2.4.9",
     "@types/supertest": "^7.2.0",
     "@types/update-notifier": "^6.0.8",
-    "@vitest/coverage-v8": "^4.1.2",
-    "@vitest/eslint-plugin": "^1.6.14",
-    "@vitest/ui": "^4.1.2",
-    "eslint": "^10.2.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "@vitest/eslint-plugin": "^1.6.16",
+    "@vitest/ui": "^4.1.5",
+    "eslint": "^10.3.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-n": "^17.24.0",
-    "nock": "^14.0.12",
+    "nock": "^14.0.14",
     "openapi-typescript": "^7.13.0",
-    "prettier": "^3.8.1",
+    "prettier": "^3.8.3",
     "supertest": "^7.2.2",
-    "tsc-alias": "^1.8.16",
+    "tsc-alias": "^1.8.17",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.58.0",
-    "vitest": "^4.1.2"
+    "typescript-eslint": "^8.59.1",
+    "vitest": "^4.1.5"
   },
-  "packageManager": "pnpm@10.33.0",
+  "packageManager": "pnpm@10.33.2",
   "engines": {
     "node": ">=18.0.0"
   },