ebay-mcp 1.18.3 → 2.0.1

package/build/utils/communication/feedback.js

@@ -34,8 +34,8 @@ const sortSchema = z
     description: 'Sort order for results',
 })
     .optional();
-/** Schema for getAwaitingFeedback input. */
-export const getAwaitingFeedbackSchema = z.object({
+/** Schema for getItemsAwaitingFeedback input. */
+export const getItemsAwaitingFeedbackSchema = z.object({
     filter: filterSchema,
     limit: limitSchema,
     offset: offsetSchema,
@@ -100,7 +100,7 @@ export const getFeedbackRatingSummarySchema = z.object({
     }),
 });
 /** Schema for leaveFeedback input. */
-export const leaveFeedbackForBuyerSchema = z.object({
+export const leaveFeedbackSchema = z.object({
     commentText: z
         .string({
         invalid_type_error: 'commentText must be a string',

package/build/utils/errors.js

@@ -41,6 +41,7 @@ const KIND_IS_GUIDANCE = {
     tokenAcquisition: true,
     missingAccessToken: true,
     tokenRefresh: true,
+    signing: true,
     remoteRateLimit: true,
     httpStatus: false,
     transport: false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ebay-mcp",
-  "version": "1.18.3",
-  "description": "Model Context Protocol (MCP) server that exposes 100% of eBay's Sell APIs (384 tools across 360 endpoints) to AI assistants like Claude, Cursor, and Cline, covering inventory, order fulfillment, marketing, analytics, and developer tools with OAuth authentication and refresh-token support.",
+  "version": "2.0.1",
+  "description": "Model Context Protocol (MCP) server that exposes 100% of the eBay Sell, Commerce and Developer APIs it tracks (379 tools across 356 endpoints) to AI assistants like Claude, Cursor, and Cline, covering inventory, order fulfillment, marketing, analytics, and developer tools with OAuth authentication and refresh-token support.",
   "type": "module",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -54,7 +54,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "1.7.4",
-    "@modelcontextprotocol/sdk": "1.29.0",
+    "@modelcontextprotocol/sdk": "1.32.1",
     "chalk": "^5.6.2",
     "cors": "^2.8.6",
     "dotenv": "^17.4.2",
@@ -93,10 +93,10 @@
     "typescript": "^5.9.3",
     "vite": "^7.3.5",
     "vite-plugin-singlefile": "2.3.3",
-    "vitest": "^4.1.9"
+    "vitest": "^4.1.12"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=24"
   },
   "scripts": {
     "build": "tsc && tsc-alias && pnpm run build:mcp-apps",

package/build/api/other/compliance.js

@@ -1,60 +0,0 @@
-import { EbayApiError } from '../../api/shared/request.js';
-import { Effect } from 'effect';
-/**
- * eBay decommissioned the Sell Compliance API on 2026-03-30 with no API
- * replacement. Seller Hub → Performance → Issue Resolution Center is the UI path.
- *
- * @see https://developer.ebay.com/develop/guides/api-deprecation-status
- */
-const COMPLIANCE_API_DECOMMISSIONED_MESSAGE = 'eBay decommissioned the Sell Compliance API on 2026-03-30. There is no API equivalent; use Seller Hub → Performance → Issue Resolution Center instead.';
-const failDecommissioned = (path) => Effect.fail(new EbayApiError({
-    method: 'GET',
-    path,
-    cause: new Error(COMPLIANCE_API_DECOMMISSIONED_MESSAGE),
-}));
-/** Clear error copy exported for tests and callers that match on the message. */
-export { COMPLIANCE_API_DECOMMISSIONED_MESSAGE };
-/** Compliance API - listing policy violation checks (decommissioned by eBay). */
-export class ComplianceApi {
-    basePath = '/sell/compliance/v1';
-    constructor(_client) {
-        // Client is unused: eBay decommissioned this API, so methods never call the network.
-        void _client;
-    }
-    /**
-     * Always fails: eBay decommissioned the Sell Compliance API on 2026-03-30.
-     *
-     * @param _input - Ignored; retained so existing call sites type-check.
-     * @returns An Effect that always fails with a clear decommission message.
-     *
-     * @example
-     * ```ts
-     * // Rejects with COMPLIANCE_API_DECOMMISSIONED_MESSAGE — no network call.
-     * await Effect.runPromise(complianceApi.getListingViolations({}));
-     * ```
-     *
-     * @see https://developer.ebay.com/api-docs/sell/compliance/resources/listing_violation/methods/getListingViolations
-     */
-    getListingViolations = (_input = {}) => {
-        void _input;
-        return failDecommissioned(`${this.basePath}/listing_violation`);
-    };
-    /**
-     * Always fails: eBay decommissioned the Sell Compliance API on 2026-03-30.
-     *
-     * @param _input - Ignored; retained so existing call sites type-check.
-     * @returns An Effect that always fails with a clear decommission message.
-     *
-     * @example
-     * ```ts
-     * // Rejects with COMPLIANCE_API_DECOMMISSIONED_MESSAGE — no network call.
-     * await Effect.runPromise(complianceApi.getListingViolationsSummary({}));
-     * ```
-     *
-     * @see https://developer.ebay.com/api-docs/sell/compliance/resources/listing_violation_summary/methods/getListingViolationsSummary
-     */
-    getListingViolationsSummary = (_input = {}) => {
-        void _input;
-        return failDecommissioned(`${this.basePath}/listing_violation_summary`);
-    };
-}

package/build/api/other/finding.js

@@ -1,280 +0,0 @@
-import { EbayApiError, EndpointInputError, optionalPositiveNumberEffect, requireObjectEffect, requireStringEffect, } from '../../api/shared/request.js';
-import { isRecord } from '../../utils/typeGuards.js';
-import { Effect } from 'effect';
-/** Finding Service API version used for findCompletedItems. */
-const FINDING_SERVICE_VERSION = '1.13.0';
-/** Default page size when maxResults is omitted. */
-const DEFAULT_MAX_RESULTS = 20;
-/** Hard upper bound for paginationInput.entriesPerPage. */
-const MAX_ENTRIES_PER_PAGE = 100;
-/** Hard upper bound for the EndTimeFrom days-back window. */
-const MAX_DAYS_BACK = 90;
-/**
- * Resolve the Finding Service base URL for the configured environment.
- *
- * Finding lives on the `svcs` host, not the Sell REST `api` host. When a proxy
- * base URL is configured, the Finding path is appended so the proxy can route it.
- *
- * @param environment - eBay environment used when no override is configured.
- * @param overrideBaseUrl - Optional base URL override from `EBAY_MCP_API_BASE_URL`.
- * @returns Absolute Finding Service URL (no trailing slash).
- *
- * @example
- * ```ts
- * const url = getFindingServiceBaseUrl('production');
- * // https://svcs.ebay.com/services/search/FindingService/v1
- * ```
- */
-export const getFindingServiceBaseUrl = (environment, overrideBaseUrl) => {
-    if (overrideBaseUrl) {
-        return `${overrideBaseUrl.replace(/\/$/, '')}/services/search/FindingService/v1`;
-    }
-    return environment === 'production'
-        ? 'https://svcs.ebay.com/services/search/FindingService/v1'
-        : 'https://svcs.sandbox.ebay.com/services/search/FindingService/v1';
-};
-/**
- * Build query parameters for Finding API findCompletedItems.
- *
- * Finding authenticates primarily via `SECURITY-APPNAME` (the app client id).
- * Results are limited to sold listings through the `SoldItemsOnly` item filter.
- *
- * @param input - Validated search input plus the app client id.
- * @returns Wire query params for the Finding Service GET request.
- *
- * @example
- * ```ts
- * const params = buildFindCompletedItemsParams({
- *   keywords: 'iphone 14',
- *   maxResults: 20,
- *   appId: 'client-id',
- * });
- * ```
- */
-export const buildFindCompletedItemsParams = (input) => {
-    const params = {
-        'OPERATION-NAME': 'findCompletedItems',
-        'SERVICE-VERSION': FINDING_SERVICE_VERSION,
-        'SECURITY-APPNAME': input.appId,
-        'RESPONSE-DATA-FORMAT': 'JSON',
-        'REST-PAYLOAD': '',
-        keywords: input.keywords,
-        'paginationInput.entriesPerPage': input.maxResults,
-        'itemFilter(0).name': 'SoldItemsOnly',
-        'itemFilter(0).value': 'true',
-    };
-    if (input.daysBack !== undefined) {
-        const endTimeFrom = new Date();
-        endTimeFrom.setUTCDate(endTimeFrom.getUTCDate() - input.daysBack);
-        params['itemFilter(1).name'] = 'EndTimeFrom';
-        params['itemFilter(1).value'] = endTimeFrom.toISOString();
-    }
-    return params;
-};
-/** Read the first string from a Finding JSON array-or-string field. */
-const firstString = (rawField) => {
-    if (typeof rawField === 'string' && rawField.length > 0) {
-        return rawField;
-    }
-    if (Array.isArray(rawField) && typeof rawField[0] === 'string' && rawField[0].length > 0) {
-        return rawField[0];
-    }
-};
-/** Read the first object from a Finding JSON array-or-object field. */
-const firstRecord = (rawField) => {
-    if (isRecord(rawField)) {
-        return rawField;
-    }
-    if (Array.isArray(rawField) && isRecord(rawField[0])) {
-        return rawField[0];
-    }
-};
-/** Parse a Finding API money field (`@currencyId` + `__value__`). */
-const parseMoney = (rawMoney) => {
-    const money = firstRecord(rawMoney);
-    if (!money) {
-        return;
-    }
-    const currency = typeof money['@currencyId'] === 'string'
-        ? money['@currencyId']
-        : typeof money.currencyId === 'string'
-            ? money.currencyId
-            : undefined;
-    const amount = typeof money.__value__ === 'string'
-        ? money.__value__
-        : typeof money.value === 'string'
-            ? money.value
-            : undefined;
-    if (!(currency && amount)) {
-        return;
-    }
-    return { currency, value: amount };
-};
-/**
- * Map one raw Finding item into a cleaned {@link CompletedItem}.
- *
- * @param raw - One item object from `searchResult.item`.
- * @returns Cleaned item, or undefined when itemId/title are missing.
- */
-export const mapFindingItem = (raw) => {
-    if (!isRecord(raw)) {
-        return;
-    }
-    const itemId = firstString(raw.itemId);
-    const title = firstString(raw.title);
-    if (!(itemId && title)) {
-        return;
-    }
-    const sellingStatus = firstRecord(raw.sellingStatus);
-    const shippingInfo = firstRecord(raw.shippingInfo);
-    const listingInfo = firstRecord(raw.listingInfo);
-    const condition = firstRecord(raw.condition);
-    const price = parseMoney(sellingStatus?.currentPrice);
-    const shippingCost = parseMoney(shippingInfo?.shippingServiceCost);
-    const soldDate = firstString(listingInfo?.endTime);
-    const conditionName = firstString(condition?.conditionDisplayName);
-    const listingUrl = firstString(raw.viewItemURL);
-    return {
-        itemId,
-        title,
-        ...(price === undefined ? {} : { price }),
-        ...(shippingCost === undefined ? {} : { shippingCost }),
-        ...(soldDate === undefined ? {} : { soldDate }),
-        ...(conditionName === undefined ? {} : { condition: conditionName }),
-        ...(listingUrl === undefined ? {} : { listingUrl }),
-    };
-};
-/**
- * Map a raw Finding findCompletedItems JSON response into cleaned sold comps.
- *
- * Finding wraps most nodes in single-element arrays (XML→JSON conversion).
- *
- * @param raw - Full JSON body returned by the Finding Service.
- * @param keywords - Keywords used for the request (echoed in the result).
- * @returns Cleaned items plus optional total entry count.
- *
- * @example
- * ```ts
- * const soldListings = mapFindCompletedItemsResponse(rawJson, 'iphone 14');
- * ```
- */
-export const mapFindCompletedItemsResponse = (raw, keywords) => {
-    if (!isRecord(raw)) {
-        return { items: [], keywords };
-    }
-    const responseRoot = firstRecord(raw.findCompletedItemsResponse);
-    if (!responseRoot) {
-        return { items: [], keywords };
-    }
-    const searchResult = firstRecord(responseRoot.searchResult);
-    const rawItems = searchResult?.item;
-    const itemList = Array.isArray(rawItems) ? rawItems : rawItems === undefined ? [] : [rawItems];
-    const items = [];
-    for (const entry of itemList) {
-        const mapped = mapFindingItem(entry);
-        if (mapped) {
-            items.push(mapped);
-        }
-    }
-    const pagination = firstRecord(responseRoot.paginationOutput);
-    const totalRaw = firstString(pagination?.totalEntries);
-    const totalEntries = totalRaw !== undefined && Number.isFinite(Number(totalRaw)) ? Number(totalRaw) : undefined;
-    return {
-        items,
-        keywords,
-        ...(totalEntries === undefined ? {} : { totalEntries }),
-    };
-};
-/**
- * Validate maxResults falls within Finding's supported range.
- *
- * @param maxResults - Positive page size already validated as > 0.
- * @returns The same value when in range, or a tagged input error.
- */
-const requireMaxResultsInRange = (maxResults) => {
-    if (maxResults > MAX_ENTRIES_PER_PAGE) {
-        return Effect.fail(new EndpointInputError({
-            parameter: 'maxResults',
-            message: `maxResults must be between 1 and ${MAX_ENTRIES_PER_PAGE}`,
-        }));
-    }
-    return Effect.succeed(maxResults);
-};
-/**
- * Validate daysBack falls within the supported window when provided.
- *
- * @param daysBack - Optional positive day count.
- * @returns The same value (or undefined) when valid, or a tagged input error.
- */
-const requireDaysBackInRange = (daysBack) => {
-    if (daysBack === undefined) {
-        return Effect.succeed(undefined);
-    }
-    if (daysBack > MAX_DAYS_BACK) {
-        return Effect.fail(new EndpointInputError({
-            parameter: 'daysBack',
-            message: `daysBack must be between 1 and ${MAX_DAYS_BACK}`,
-        }));
-    }
-    return Effect.succeed(daysBack);
-};
-/** Finding API - sold/completed listing search for pricing research. */
-export class FindingApi {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    /**
-     * Search sold and completed eBay listings for pricing comps.
-     *
-     * Uses the legacy Finding API (`findCompletedItems`) with app credentials
-     * (`SECURITY-APPNAME`). Useful for market price research; sold listings only.
-     *
-     * @param input - Keywords plus optional result cap and days-back window.
-     * @returns An Effect that succeeds with cleaned sold-item comps.
-     *
-     * @example
-     * ```ts
-     * const comps = await Effect.runPromise(
-     *   findingApi.findCompletedItems({ keywords: 'nike dunk low', maxResults: 25, daysBack: 30 }),
-     * );
-     * ```
-     *
-     * @see https://developer.ebay.com/devzone/finding/callref/findCompletedItems.html
-     */
-    findCompletedItems = (input) => {
-        const client = this.client;
-        return Effect.gen(function* () {
-            const validatedInput = yield* requireObjectEffect(input, 'input');
-            const keywords = yield* requireStringEffect(validatedInput.keywords, 'keywords');
-            const maxResultsRaw = yield* optionalPositiveNumberEffect(validatedInput.maxResults, 'maxResults');
-            const daysBackRaw = yield* optionalPositiveNumberEffect(validatedInput.daysBack, 'daysBack');
-            const maxResults = yield* requireMaxResultsInRange(maxResultsRaw ?? DEFAULT_MAX_RESULTS);
-            const daysBack = yield* requireDaysBackInRange(daysBackRaw);
-            const config = client.getConfig();
-            const appId = config.clientId;
-            if (!appId) {
-                return yield* Effect.fail(new EndpointInputError({
-                    parameter: 'clientId',
-                    message: 'EBAY_CLIENT_ID is required for Finding API requests (SECURITY-APPNAME). Set it in your environment.',
-                }));
-            }
-            const baseUrl = getFindingServiceBaseUrl(config.environment, config.apiBaseUrl);
-            const params = buildFindCompletedItemsParams({
-                keywords,
-                maxResults,
-                ...(daysBack === undefined ? {} : { daysBack }),
-                appId,
-            });
-            const raw = yield* Effect.tryPromise({
-                try: () => client.getWithFullUrl(baseUrl, params),
-                catch: (cause) => new EbayApiError({
-                    method: 'GET',
-                    path: baseUrl,
-                    cause,
-                }),
-            });
-            return mapFindCompletedItemsResponse(raw, keywords);
-        });
-    };
-}

package/build/schemas/other/finding.js

@@ -1,27 +0,0 @@
-import { z } from 'zod';
-/**
- * Finding API Schemas
- *
- * Zod input schemas for sold/completed listing search tools.
- */
-/**
- * Validates input for ebay_find_completed_items (Finding API findCompletedItems).
- */
-export const findCompletedItemsInputSchema = z.object({
-    keywords: z
-        .string()
-        .min(1)
-        .describe('Search keywords for sold/completed listings (e.g. "iphone 14 pro 256")'),
-    maxResults: z
-        .number()
-        .int()
-        .positive()
-        .optional()
-        .describe('Maximum sold items to return (1–100). Defaults to 20.'),
-    daysBack: z
-        .number()
-        .int()
-        .positive()
-        .optional()
-        .describe('Only include items that ended within this many days (1–90).'),
-});

package/build/utils/other/compliance.js

@@ -1,56 +0,0 @@
-import { z } from 'zod';
-/**
- * Zod schemas for Compliance API input validation
- * Based on: src/api/other/compliance.ts
- * OpenAPI spec: sell_compliance_v1_oas3.json
- * Types from: src/types/sell_compliance_v1_oas3.ts
- */
-// Reusable schema for complianceType parameter
-const complianceTypeSchema = z
-    .string({
-    invalid_type_error: 'complianceType must be a string',
-    description: 'Compliance type(s) to filter violations (e.g., ASPECTS_ADOPTION, HTTPS, OUTSIDE_EBAY_BUYING_AND_SELLING, RETURNS_POLICY)',
-})
-    .optional();
-// Reusable schema for offset parameter
-const offsetSchema = z
-    .number({
-    invalid_type_error: 'offset must be a number',
-    description: 'Number of items to skip (zero-based index)',
-})
-    .int()
-    .nonnegative()
-    .optional();
-// Reusable schema for limit parameter
-const limitSchema = z
-    .number({
-    invalid_type_error: 'limit must be a number',
-    description: 'Maximum number of items to return (default: 100, max: 200)',
-})
-    .int()
-    .positive()
-    .optional();
-/**
- * Schema for getListingViolations method
- * Endpoint: GET /listing_violation
- * Query: complianceType, offset, limit, filter
- */
-export const getListingViolationsSchema = z.object({
-    complianceType: complianceTypeSchema,
-    offset: offsetSchema,
-    limit: limitSchema,
-    filter: z
-        .string({
-        invalid_type_error: 'filter must be a string',
-        description: 'Filter by compliance state (e.g., complianceState:{OUT_OF_COMPLIANCE})',
-    })
-        .optional(),
-});
-/**
- * Schema for getListingViolationsSummary method
- * Endpoint: GET /listing_violation_summary
- * Query: complianceType
- */
-export const getListingViolationsSummarySchema = z.object({
-    complianceType: complianceTypeSchema,
-});