ebay-mcp 1.4.3

package/build/tools/definitions/fulfillment.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { OutputArgs, ToolAnnotations } from '../tool-definitions.js';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, z.ZodTypeAny>;
+    title?: string;
+    outputSchema?: OutputArgs;
+    annotations?: ToolAnnotations;
+    _meta?: Record<string, unknown>;
+}
+export declare const fulfillmentTools: ToolDefinition[];

package/build/tools/definitions/fulfillment.js

@@ -0,0 +1,326 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { shippingFulfillmentSchema } from '../schemas.js';
+import { getOrdersOutputSchema, getOrderOutputSchema, createShippingFulfillmentOutputSchema, getShippingFulfillmentsOutputSchema, issueRefundOutputSchema, getPaymentDisputesOutputSchema, } from '../../schemas/fulfillment/orders.js';
+export const fulfillmentTools = [
+    {
+        name: 'ebay_get_orders',
+        description: 'Retrieve orders for the seller.\n\nRequired OAuth Scope: sell.fulfillment.readonly or sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly',
+        inputSchema: {
+            filter: z
+                .string()
+                .optional()
+                .describe('Filter criteria (e.g., orderfulfillmentstatus:{NOT_STARTED})'),
+            limit: z.number().optional().describe('Number of orders to return'),
+            offset: z.number().optional().describe('Number of orders to skip'),
+        },
+        outputSchema: zodToJsonSchema(getOrdersOutputSchema, {
+            name: 'GetOrdersResponse',
+            $refStrategy: 'none',
+        }),
+    },
+    {
+        name: 'ebay_get_order',
+        description: 'Get details of a specific order.\n\nRequired OAuth Scope: sell.fulfillment.readonly or sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly',
+        inputSchema: {
+            orderId: z.string().describe('The unique order ID'),
+        },
+        outputSchema: zodToJsonSchema(getOrderOutputSchema, {
+            name: 'GetOrderResponse',
+            $refStrategy: 'none',
+        }),
+    },
+    {
+        name: 'ebay_create_shipping_fulfillment',
+        description: 'Create a shipping fulfillment for an order.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            orderId: z.string().describe('The order ID'),
+            fulfillment: shippingFulfillmentSchema.describe('Shipping fulfillment details including tracking number'),
+        },
+        outputSchema: zodToJsonSchema(createShippingFulfillmentOutputSchema, {
+            name: 'CreateShippingFulfillmentResponse',
+            $refStrategy: 'none',
+        }),
+    },
+    {
+        name: 'ebay_get_shipping_fulfillments',
+        description: 'Get all shipping fulfillments for an order.\n\nRequired OAuth Scope: sell.fulfillment.readonly or sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly',
+        inputSchema: {
+            orderId: z.string().describe('The order ID to get fulfillments for'),
+        },
+        outputSchema: zodToJsonSchema(getShippingFulfillmentsOutputSchema, {
+            name: 'GetShippingFulfillmentsResponse',
+            $refStrategy: 'none',
+        }),
+    },
+    {
+        name: 'ebay_get_shipping_fulfillment',
+        description: 'Get a specific shipping fulfillment by ID.\n\nRequired OAuth Scope: sell.fulfillment.readonly or sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly',
+        inputSchema: {
+            orderId: z.string().describe('The order ID'),
+            fulfillmentId: z.string().describe('The fulfillment ID'),
+        },
+        outputSchema: zodToJsonSchema(createShippingFulfillmentOutputSchema, {
+            name: 'GetShippingFulfillmentResponse',
+            $refStrategy: 'none',
+        }),
+    },
+    {
+        name: 'ebay_issue_refund',
+        description: 'Issue a full or partial refund for an eBay order. Use this to refund buyers for orders, including specifying the refund amount and reason.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            orderId: z.string().describe('The unique eBay order ID to refund'),
+            refundData: z
+                .object({
+                reasonForRefund: z
+                    .string()
+                    .describe('REQUIRED. Reason code: BUYER_CANCEL, OUT_OF_STOCK, FOUND_CHEAPER_PRICE, INCORRECT_PRICE, ITEM_DAMAGED, ITEM_DEFECTIVE, LOST_IN_TRANSIT, MUTUALLY_AGREED, SELLER_CANCEL'),
+                comment: z
+                    .string()
+                    .optional()
+                    .describe('Optional comment to buyer about the refund (max 100 characters)'),
+                refundItems: z
+                    .array(z.object({
+                    lineItemId: z
+                        .string()
+                        .describe('The unique identifier of the order line item to refund'),
+                    refundAmount: z
+                        .object({
+                        value: z.string().describe('The monetary amount (e.g., "25.99")'),
+                        currency: z
+                            .string()
+                            .describe('Three-letter ISO 4217 currency code (e.g., "USD")'),
+                    })
+                        .optional()
+                        .describe('The amount to refund for this line item'),
+                    legacyReference: z
+                        .object({
+                        legacyItemId: z.string().optional(),
+                        legacyTransactionId: z.string().optional(),
+                    })
+                        .optional()
+                        .describe('Optional legacy item ID/transaction ID pair for identifying the line item'),
+                }))
+                    .optional()
+                    .describe('Array of individual line items to refund. Use this for partial refunds of specific items. Each item requires lineItemId and refundAmount.'),
+                orderLevelRefundAmount: z
+                    .object({
+                    value: z.string().describe('The monetary amount (e.g., "99.99")'),
+                    currency: z.string().describe('Three-letter ISO 4217 currency code (e.g., "USD")'),
+                })
+                    .optional()
+                    .describe('Use this to refund the entire order amount. Alternative to refundItems. Include value and currency.'),
+            })
+                .describe('Refund details including amount, reason, and optional comment. Must include reasonForRefund (required), and either refundItems (for line item refunds) OR orderLevelRefundAmount (for full order refunds).'),
+        },
+        outputSchema: zodToJsonSchema(issueRefundOutputSchema, {
+            name: 'IssueRefundResponse',
+            $refStrategy: 'none',
+        }),
+    },
+    // Payment Dispute Tools
+    {
+        name: 'ebay_get_payment_dispute_summaries',
+        description: 'Get summaries of all payment disputes. Use filters to narrow results by dispute status, buyer username, or order ID.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            orderFilter: z
+                .string()
+                .optional()
+                .describe('Filter by order ID (e.g., orderid:170123456789)'),
+            buyerFilter: z
+                .string()
+                .optional()
+                .describe('Filter by buyer username (e.g., buyer_username:testbuyer)'),
+            openFilter: z
+                .boolean()
+                .optional()
+                .describe('If true, only return open disputes. If false, only return closed disputes'),
+            limit: z.number().optional().describe('Maximum number of disputes to return (default: 200)'),
+            offset: z.number().optional().describe('Number of disputes to skip for pagination'),
+        },
+        outputSchema: zodToJsonSchema(getPaymentDisputesOutputSchema, {
+            name: 'GetPaymentDisputeSummariesResponse',
+            $refStrategy: 'none',
+        }),
+    },
+    {
+        name: 'ebay_get_payment_dispute',
+        description: 'Get detailed information about a specific payment dispute.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            paymentDisputeId: z.string().describe('The unique payment dispute ID'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                paymentDisputeId: { type: 'string' },
+                orderId: { type: 'string' },
+                status: { type: 'string' },
+                reason: { type: 'string' },
+                amount: { type: 'object' },
+            },
+            description: 'Payment dispute details',
+        },
+    },
+    {
+        name: 'ebay_get_payment_dispute_activities',
+        description: 'Get activity history for a payment dispute, including all actions taken by buyer, seller, and eBay.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            paymentDisputeId: z.string().describe('The payment dispute ID'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                activity: { type: 'array' },
+            },
+            description: 'Payment dispute activity history',
+        },
+    },
+    {
+        name: 'ebay_accept_payment_dispute',
+        description: 'Accept a payment dispute and allow eBay to refund the buyer. Use this when you agree with the buyer claim.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            paymentDisputeId: z.string().describe('The payment dispute ID to accept'),
+            returnAddress: z
+                .object({
+                addressLine1: z.string().optional().describe('Street address line 1'),
+                addressLine2: z.string().optional().describe('Street address line 2'),
+                city: z.string().optional().describe('City name'),
+                stateOrProvince: z.string().optional().describe('State or province'),
+                postalCode: z.string().optional().describe('Postal/ZIP code'),
+                countryCode: z.string().describe('Two-letter ISO 3166-1 country code (e.g., "US")'),
+            })
+                .optional()
+                .describe('Return address for buyer to send item back (required for ITEM_NOT_RECEIVED disputes)'),
+            revisionNumber: z
+                .number()
+                .optional()
+                .describe('Dispute revision number for optimistic locking'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {},
+            description: 'Empty response on successful acceptance (HTTP 204)',
+        },
+    },
+    {
+        name: 'ebay_contest_payment_dispute',
+        description: 'Contest a payment dispute by providing evidence. Use this when you disagree with the buyer claim and want to provide proof.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            paymentDisputeId: z.string().describe('The payment dispute ID to contest'),
+            returnAddress: z
+                .object({
+                addressLine1: z.string().optional(),
+                addressLine2: z.string().optional(),
+                city: z.string().optional(),
+                stateOrProvince: z.string().optional(),
+                postalCode: z.string().optional(),
+                countryCode: z.string().describe('Two-letter ISO 3166-1 country code'),
+            })
+                .optional()
+                .describe('Return address for item returns (if applicable)'),
+            revisionNumber: z.number().optional().describe('Dispute revision number'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {},
+            description: 'Empty response on successful contest (HTTP 204)',
+        },
+    },
+    {
+        name: 'ebay_add_payment_dispute_evidence',
+        description: 'Add evidence to support your case in a payment dispute. Provide evidence files and supporting information.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            paymentDisputeId: z.string().describe('The payment dispute ID'),
+            evidenceId: z
+                .string()
+                .optional()
+                .describe('Optional evidence ID to update existing evidence'),
+            evidenceType: z
+                .string()
+                .optional()
+                .describe('Type of evidence (e.g., PROOF_OF_DELIVERY, PROOF_OF_AUTHENTICITY)'),
+            files: z
+                .array(z.object({
+                fileId: z.string().describe('File ID from uploadEvidenceFile'),
+            }))
+                .optional()
+                .describe('Array of file IDs to attach as evidence'),
+            lineItems: z
+                .array(z.object({
+                itemId: z.string().optional().describe('eBay item ID'),
+                lineItemId: z.string().optional().describe('Order line item ID'),
+            }))
+                .optional()
+                .describe('Line items this evidence applies to'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {},
+            description: 'Empty response on successful evidence addition (HTTP 204)',
+        },
+    },
+    {
+        name: 'ebay_update_payment_dispute_evidence',
+        description: 'Update existing evidence in a payment dispute.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            paymentDisputeId: z.string().describe('The payment dispute ID'),
+            evidenceId: z.string().describe('The evidence ID to update'),
+            evidenceType: z.string().optional().describe('Updated evidence type'),
+            files: z
+                .array(z.object({
+                fileId: z.string(),
+            }))
+                .optional()
+                .describe('Updated file IDs'),
+            lineItems: z
+                .array(z.object({
+                itemId: z.string().optional(),
+                lineItemId: z.string().optional(),
+            }))
+                .optional()
+                .describe('Updated line items'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {},
+            description: 'Empty response on successful evidence update (HTTP 204)',
+        },
+    },
+    {
+        name: 'ebay_upload_payment_dispute_evidence_file',
+        description: 'Upload a file as evidence for a payment dispute (e.g., shipping receipt, photos). Returns a file ID to use with add_evidence.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            paymentDisputeId: z.string().describe('The payment dispute ID'),
+            file: z
+                .object({
+                data: z.string().describe('Base64-encoded file data'),
+                filename: z.string().describe('File name with extension'),
+            })
+                .describe('File to upload'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                fileId: { type: 'string' },
+            },
+            description: 'File upload response with file ID',
+        },
+    },
+    {
+        name: 'ebay_fetch_payment_dispute_evidence_content',
+        description: 'Download evidence file content from a payment dispute.\n\nRequired OAuth Scope: sell.fulfillment\nMinimum Scope: https://api.ebay.com/oauth/api_scope/sell.fulfillment',
+        inputSchema: {
+            paymentDisputeId: z.string().describe('The payment dispute ID'),
+            evidenceId: z.string().describe('The evidence ID'),
+            fileId: z.string().describe('The file ID to download'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                content: { type: 'string' },
+                contentType: { type: 'string' },
+            },
+            description: 'File content and content type',
+        },
+    },
+];

package/build/tools/definitions/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tool Definitions Index
+ *
+ * This file aggregates all tool definitions from category-specific files.
+ * Each category is in its own file for better organization and reduced context.
+ *
+ * Benefits:
+ * - Reduced file size (each file ~50-300 lines vs 1,402 lines)
+ * - Better organization by API domain
+ * - Easier to find and modify tools
+ * - Less context for AI to process per category
+ */
+import { tokenManagementTools } from './token-management.js';
+import { accountTools } from './account.js';
+import { inventoryTools } from './inventory.js';
+import { fulfillmentTools } from './fulfillment.js';
+import { marketingTools } from './marketing.js';
+import { analyticsTools } from './analytics.js';
+import { metadataTools } from './metadata.js';
+import { taxonomyTools } from './taxonomy.js';
+import { communicationTools } from './communication.js';
+import { otherApiTools } from './other.js';
+export { tokenManagementTools, accountTools, inventoryTools, fulfillmentTools, marketingTools, analyticsTools, metadataTools, taxonomyTools, communicationTools, otherApiTools, };
+export declare const allTools: import("./token-management.js").ToolDefinition[];
+export type { ToolDefinition } from './account.js';

package/build/tools/definitions/index.js

@@ -0,0 +1,37 @@
+/**
+ * Tool Definitions Index
+ *
+ * This file aggregates all tool definitions from category-specific files.
+ * Each category is in its own file for better organization and reduced context.
+ *
+ * Benefits:
+ * - Reduced file size (each file ~50-300 lines vs 1,402 lines)
+ * - Better organization by API domain
+ * - Easier to find and modify tools
+ * - Less context for AI to process per category
+ */
+import { tokenManagementTools } from './token-management.js';
+import { accountTools } from './account.js';
+import { inventoryTools } from './inventory.js';
+import { fulfillmentTools } from './fulfillment.js';
+import { marketingTools } from './marketing.js';
+import { analyticsTools } from './analytics.js';
+import { metadataTools } from './metadata.js';
+import { taxonomyTools } from './taxonomy.js';
+import { communicationTools } from './communication.js';
+import { otherApiTools } from './other.js';
+// Export individual categories
+export { tokenManagementTools, accountTools, inventoryTools, fulfillmentTools, marketingTools, analyticsTools, metadataTools, taxonomyTools, communicationTools, otherApiTools, };
+// Export all tools as a single array
+export const allTools = [
+    ...tokenManagementTools,
+    ...accountTools,
+    ...inventoryTools,
+    ...fulfillmentTools,
+    ...marketingTools,
+    ...analyticsTools,
+    ...metadataTools,
+    ...taxonomyTools,
+    ...communicationTools,
+    ...otherApiTools,
+];

package/build/tools/definitions/inventory.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { OutputArgs, ToolAnnotations } from '../tool-definitions.js';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, z.ZodTypeAny>;
+    title?: string;
+    outputSchema?: OutputArgs;
+    annotations?: ToolAnnotations;
+    _meta?: Record<string, unknown>;
+}
+export declare const inventoryTools: ToolDefinition[];