ebay-mcp-remote-edition 1.0.0

package/build/tools/definitions/communication.js

@@ -0,0 +1,394 @@
+import { z } from 'zod';
+import { feedbackDataSchema, notificationConfigSchema, notificationDestinationSchema, offerToBuyersSchema, } from '../schemas.js';
+export const communicationTools = [
+    // Negotiation API
+    {
+        name: 'ebay_get_offers_to_buyers',
+        description: 'Get offers to buyers (Best Offers) for the seller',
+        inputSchema: {
+            filter: z.string().optional().describe('Filter criteria for offers'),
+            limit: z.number().optional().describe('Number of offers to return'),
+            offset: z.number().optional().describe('Number of offers to skip'),
+        },
+    },
+    {
+        name: 'ebay_send_offer_to_interested_buyers',
+        description: 'Send offer to interested buyers',
+        inputSchema: {
+            offerId: z.string().describe('The offer ID'),
+            offerData: offerToBuyersSchema.describe('Offer details to send to buyers'),
+        },
+    },
+    // Message API
+    {
+        name: 'ebay_search_messages',
+        description: 'Search for buyer-seller messages',
+        inputSchema: {
+            filter: z.string().optional().describe('Filter criteria for messages'),
+            limit: z.number().optional().describe('Number of messages to return'),
+            offset: z.number().optional().describe('Number of messages to skip'),
+        },
+    },
+    {
+        name: 'ebay_get_message',
+        description: 'Get a specific message by ID',
+        inputSchema: {
+            messageId: z.string().describe('The message ID'),
+        },
+    },
+    {
+        name: 'ebay_send_message',
+        description: 'Send a direct message to a buyer regarding a specific transaction or inquiry. Use this to communicate about orders, answer questions, resolve issues, or provide updates.',
+        inputSchema: {
+            messageData: z
+                .object({
+                conversationId: z
+                    .string()
+                    .optional()
+                    .describe('Optional conversation ID to reply to an existing thread. Use getConversations to retrieve conversation IDs. Required if replying to existing conversation.'),
+                messageText: z
+                    .string()
+                    .describe('REQUIRED. The text of the message to send (max 2000 characters).'),
+                otherPartyUsername: z
+                    .string()
+                    .optional()
+                    .describe('eBay username of the other party (buyer or seller). Required when starting a new conversation.'),
+                emailCopyToSender: z
+                    .boolean()
+                    .optional()
+                    .describe('If true, a copy of the message will be emailed to the sender.'),
+                reference: z
+                    .object({
+                    referenceId: z
+                        .string()
+                        .optional()
+                        .describe('The ID of the listing or order to reference (e.g., item ID or order ID)'),
+                    referenceType: z
+                        .string()
+                        .optional()
+                        .describe('Type of reference. Valid values: "LISTING" (for item listings) or "ORDER" (for orders)'),
+                })
+                    .optional()
+                    .describe('Optional reference to associate message with a listing or order.'),
+                messageMedia: z
+                    .array(z.object({
+                    mediaUrl: z.string().optional().describe('URL of the media to attach'),
+                    mediaType: z
+                        .string()
+                        .optional()
+                        .describe('MIME type of the media (e.g., "image/jpeg")'),
+                }))
+                    .optional()
+                    .describe('Optional array of media attachments (max 5 per message)'),
+            })
+                .describe('Message details including recipient and content. Must include messageText (required), and either conversationId (for replies) OR otherPartyUsername (for new messages).'),
+        },
+    },
+    {
+        name: 'ebay_reply_to_message',
+        description: 'Reply to a buyer message in an existing conversation thread',
+        inputSchema: {
+            messageId: z.string().describe('The conversation/message ID to reply to'),
+            messageContent: z.string().describe('The reply message content'),
+        },
+    },
+    // Notification API
+    {
+        name: 'ebay_get_notification_config',
+        description: 'Get notification configuration',
+        inputSchema: {},
+    },
+    {
+        name: 'ebay_update_notification_config',
+        description: 'Update notification configuration',
+        inputSchema: {
+            config: notificationConfigSchema.describe('Notification configuration settings'),
+        },
+    },
+    {
+        name: 'ebay_get_notification_destinations',
+        description: 'Get all notification destinations (paginated)',
+        inputSchema: {
+            limit: z
+                .number()
+                .optional()
+                .describe('Maximum number of destinations to return (10-100, default: 20)'),
+            continuationToken: z.string().optional().describe('Token to retrieve next page of results'),
+        },
+    },
+    {
+        name: 'ebay_create_notification_destination',
+        description: 'Create a notification destination',
+        inputSchema: {
+            destination: notificationDestinationSchema.describe('Destination configuration'),
+        },
+    },
+    // Notification API - Destination CRUD
+    {
+        name: 'ebay_get_notification_destination',
+        description: 'Get a specific notification destination by ID',
+        inputSchema: {
+            destination_id: z.string().describe('The unique identifier for the destination'),
+        },
+    },
+    {
+        name: 'ebay_update_notification_destination',
+        description: 'Update a notification destination',
+        inputSchema: {
+            destination_id: z.string().describe('The unique identifier for the destination'),
+            delivery_config: z
+                .object({
+                endpoint: z.string().optional().describe('HTTPS endpoint URL'),
+                verification_token: z
+                    .string()
+                    .optional()
+                    .describe('Verification token (32-80 characters)'),
+            })
+                .optional()
+                .describe('Delivery configuration'),
+            name: z.string().optional().describe('Destination name'),
+            status: z.string().optional().describe('Status: ENABLED or DISABLED'),
+        },
+    },
+    {
+        name: 'ebay_delete_notification_destination',
+        description: 'Delete a notification destination',
+        inputSchema: {
+            destination_id: z.string().describe('The unique identifier for the destination'),
+        },
+    },
+    // Notification API - Subscription CRUD
+    {
+        name: 'ebay_get_notification_subscriptions',
+        description: 'Get all notification subscriptions (paginated)',
+        inputSchema: {
+            limit: z.string().optional().describe('Maximum number of subscriptions to return'),
+            continuation_token: z.string().optional().describe('Token for pagination'),
+        },
+    },
+    {
+        name: 'ebay_create_notification_subscription',
+        description: 'Create a notification subscription',
+        inputSchema: {
+            destination_id: z.string().optional().describe('The destination endpoint ID'),
+            payload: z
+                .object({
+                delivery_protocol: z.string().optional().describe('Delivery protocol (HTTPS)'),
+                format: z.string().optional().describe('Payload format (JSON)'),
+                schema_version: z.string().optional().describe('Schema version'),
+            })
+                .optional()
+                .describe('Payload configuration'),
+            status: z.string().optional().describe('Status: ENABLED or DISABLED'),
+            topic_id: z.string().optional().describe('The notification topic ID'),
+        },
+    },
+    {
+        name: 'ebay_get_notification_subscription',
+        description: 'Get a specific notification subscription by ID',
+        inputSchema: {
+            subscription_id: z.string().describe('The unique identifier for the subscription'),
+        },
+    },
+    {
+        name: 'ebay_update_notification_subscription',
+        description: 'Update a notification subscription',
+        inputSchema: {
+            subscription_id: z.string().describe('The unique identifier for the subscription'),
+            destination_id: z.string().optional().describe('The destination endpoint ID'),
+            payload: z
+                .object({
+                delivery_protocol: z.string().optional().describe('Delivery protocol'),
+                format: z.string().optional().describe('Payload format'),
+                schema_version: z.string().optional().describe('Schema version'),
+            })
+                .optional()
+                .describe('Payload configuration'),
+            status: z.string().optional().describe('Status: ENABLED or DISABLED'),
+        },
+    },
+    {
+        name: 'ebay_delete_notification_subscription',
+        description: 'Delete a notification subscription',
+        inputSchema: {
+            subscription_id: z.string().describe('The unique identifier for the subscription'),
+        },
+    },
+    {
+        name: 'ebay_disable_notification_subscription',
+        description: 'Disable a notification subscription',
+        inputSchema: {
+            subscription_id: z.string().describe('The unique identifier for the subscription'),
+        },
+    },
+    {
+        name: 'ebay_enable_notification_subscription',
+        description: 'Enable a notification subscription',
+        inputSchema: {
+            subscription_id: z.string().describe('The unique identifier for the subscription'),
+        },
+    },
+    {
+        name: 'ebay_test_notification_subscription',
+        description: 'Test a notification subscription by sending a test message',
+        inputSchema: {
+            subscription_id: z.string().describe('The unique identifier for the subscription'),
+        },
+    },
+    // Notification API - Subscription Filters
+    {
+        name: 'ebay_create_notification_subscription_filter',
+        description: 'Create a filter for a notification subscription',
+        inputSchema: {
+            subscription_id: z.string().describe('The unique identifier for the subscription'),
+            filter_schema: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('JSON Schema document to filter notifications'),
+        },
+    },
+    {
+        name: 'ebay_get_notification_subscription_filter',
+        description: 'Get a specific subscription filter',
+        inputSchema: {
+            subscription_id: z.string().describe('The unique identifier for the subscription'),
+            filter_id: z.string().describe('The unique identifier for the filter'),
+        },
+    },
+    {
+        name: 'ebay_delete_notification_subscription_filter',
+        description: 'Delete a subscription filter',
+        inputSchema: {
+            subscription_id: z.string().describe('The unique identifier for the subscription'),
+            filter_id: z.string().describe('The unique identifier for the filter'),
+        },
+    },
+    // Notification API - Topics
+    {
+        name: 'ebay_get_notification_topic',
+        description: 'Get a specific notification topic by ID',
+        inputSchema: {
+            topic_id: z.string().describe('The unique identifier for the topic'),
+        },
+    },
+    {
+        name: 'ebay_get_notification_topics',
+        description: 'Get all available notification topics (paginated)',
+        inputSchema: {
+            limit: z.string().optional().describe('Maximum number of topics to return'),
+            continuation_token: z.string().optional().describe('Token for pagination'),
+        },
+    },
+    // Notification API - Public Key
+    {
+        name: 'ebay_get_notification_public_key',
+        description: 'Get a public key for verifying notification signatures',
+        inputSchema: {
+            public_key_id: z.string().describe('The unique identifier for the public key'),
+        },
+    },
+    // Message API - Conversations
+    {
+        name: 'ebay_get_conversations',
+        description: 'Get all buyer-seller conversations (paginated)',
+        inputSchema: {
+            filter: z.string().optional().describe('Filter criteria for conversations'),
+            limit: z.number().optional().describe('Number of conversations to return'),
+            offset: z.number().optional().describe('Number of conversations to skip'),
+        },
+    },
+    {
+        name: 'ebay_get_conversation',
+        description: 'Get a specific conversation by ID',
+        inputSchema: {
+            conversation_id: z.string().describe('The unique identifier for the conversation'),
+        },
+    },
+    {
+        name: 'ebay_bulk_update_conversation',
+        description: 'Bulk update multiple conversations (read status, flagged, etc.)',
+        inputSchema: {
+            conversations: z
+                .array(z.object({
+                conversation_id: z.string().describe('The conversation ID'),
+                read: z.boolean().optional().describe('Mark as read/unread'),
+                flagged: z.boolean().optional().describe('Mark as flagged/unflagged'),
+            }))
+                .describe('Array of conversations to update'),
+        },
+    },
+    {
+        name: 'ebay_update_conversation',
+        description: 'Update a single conversation (read status, flagged, etc.)',
+        inputSchema: {
+            conversation_id: z.string().describe('The conversation ID'),
+            read: z.boolean().optional().describe('Mark as read/unread'),
+            flagged: z.boolean().optional().describe('Mark as flagged/unflagged'),
+        },
+    },
+    // Feedback API
+    {
+        name: 'ebay_get_feedback',
+        description: 'Get feedback for a user by type',
+        inputSchema: {
+            user_id: z.string().describe('The eBay username of the user'),
+            feedback_type: z.string().describe('Type: FEEDBACK_RECEIVED or FEEDBACK_SENT'),
+            feedback_id: z.string().optional().describe('Filter by specific feedback ID'),
+            filter: z.string().optional().describe('Filter criteria'),
+            limit: z.string().optional().describe('Maximum number of feedback items to return'),
+            listing_id: z.string().optional().describe('Filter by listing ID'),
+            offset: z.string().optional().describe('Number of items to skip'),
+            order_line_item_id: z.string().optional().describe('Filter by order line item ID'),
+            sort: z.string().optional().describe('Sort order'),
+            transaction_id: z.string().optional().describe('Filter by transaction ID'),
+        },
+    },
+    {
+        name: 'ebay_leave_feedback_for_buyer',
+        description: 'Leave feedback for a buyer',
+        inputSchema: {
+            feedbackData: feedbackDataSchema.describe('Feedback details including rating and comment'),
+        },
+    },
+    {
+        name: 'ebay_get_feedback_summary',
+        description: 'Get feedback summary for the seller',
+        inputSchema: {},
+        outputSchema: {
+            type: 'object',
+            properties: {},
+            description: 'Success response',
+        },
+    },
+    {
+        name: 'ebay_get_awaiting_feedback',
+        description: 'Get transactions awaiting feedback from the seller',
+        inputSchema: {
+            filter: z.string().optional().describe('Filter criteria'),
+            limit: z.string().optional().describe('Maximum number of items to return (25-200)'),
+            offset: z.string().optional().describe('Number of items to skip'),
+            sort: z.string().optional().describe('Sort order'),
+        },
+    },
+    {
+        name: 'ebay_respond_to_feedback',
+        description: 'Respond to feedback received from a buyer',
+        inputSchema: {
+            feedback_id: z.string().optional().describe('The feedback ID being responded to'),
+            recipient_user_id: z.string().optional().describe('The user ID of the feedback provider'),
+            response_text: z
+                .string()
+                .optional()
+                .describe('The response text content (max 500 characters)'),
+            response_type: z.string().optional().describe('The response type: REPLY or FOLLOW_UP'),
+        },
+    },
+    {
+        name: 'ebay_get_feedback_rating_summary',
+        description: 'Get feedback rating summary for a user',
+        inputSchema: {
+            user_id: z.string().describe('The eBay username of the user'),
+            filter: z.string().describe('Filter with required ratingType parameter'),
+        },
+    },
+];

package/build/tools/definitions/developer.js

@@ -0,0 +1,195 @@
+import { z } from 'zod';
+export const developerTools = [
+    {
+        name: 'ebay_get_api_status',
+        description: 'Get the latest eBay API status and incidents from the official RSS feed. Returns recent issues, fixes, and outages for eBay APIs (e.g. Trading API, Inventory API, Sandbox). Use when the user asks about API status, outages, or fixes.',
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe('Maximum number of items to return (default 20)'),
+            status: z
+                .enum(['Resolved', 'Unresolved'])
+                .optional()
+                .describe('Filter by status: Resolved or Unresolved'),
+            api: z
+                .string()
+                .optional()
+                .describe('Filter by API name (e.g. "Trading API", "Inventory API", "Sandbox")'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                items: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            title: { type: 'string' },
+                            summary: { type: 'string' },
+                            link: { type: 'string' },
+                            api: { type: 'string' },
+                            site: { type: 'string' },
+                            status: { type: 'string' },
+                            lastUpdated: { type: 'string' },
+                        },
+                    },
+                },
+                error: { type: 'string' },
+            },
+            description: 'Latest API status items from eBay developer feed',
+        },
+    },
+    {
+        name: 'ebay_get_rate_limits',
+        description: 'Get application rate limits for eBay APIs. Returns call quota, remaining calls, and time until reset for each API resource.',
+        inputSchema: {
+            apiContext: z
+                .string()
+                .optional()
+                .describe('Filter by API context: buy, sell, commerce, developer, or tradingapi'),
+            apiName: z
+                .string()
+                .optional()
+                .describe('Filter by specific API name: browse, inventory, taxonomy, tradingapi, etc.'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                rateLimits: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            apiContext: { type: 'string' },
+                            apiName: { type: 'string' },
+                            apiVersion: { type: 'string' },
+                            resources: { type: 'array' },
+                        },
+                    },
+                },
+            },
+            description: 'Rate limit data for application APIs',
+        },
+    },
+    {
+        name: 'ebay_get_user_rate_limits',
+        description: 'Get user-specific rate limits for eBay APIs. Returns call quota per user for APIs that limit by user.',
+        inputSchema: {
+            apiContext: z
+                .string()
+                .optional()
+                .describe('Filter by API context: buy, sell, commerce, developer, or tradingapi'),
+            apiName: z
+                .string()
+                .optional()
+                .describe('Filter by specific API name: browse, inventory, taxonomy, tradingapi, etc.'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                rateLimits: { type: 'array' },
+            },
+            description: 'Rate limit data for user APIs',
+        },
+    },
+    {
+        name: 'ebay_register_client',
+        description: 'Register a third party financial application with eBay (Open Banking / PSD2). Requires valid eIDAS certificate via MTLS.',
+        inputSchema: {
+            clientSettings: z
+                .object({
+                client_name: z.string().optional().describe('User-friendly name for the application'),
+                contacts: z.array(z.string()).optional().describe('Array of contact email addresses'),
+                policy_uri: z.string().optional().describe('HTTPS URL to privacy policy document'),
+                redirect_uris: z.array(z.string()).optional().describe('Array of redirect URIs'),
+                software_id: z.string().optional().describe('Unique identifier for the client software'),
+                software_statement: z
+                    .string()
+                    .optional()
+                    .describe('Base64-encoded Software Statement Assertion (SSA) JWT'),
+            })
+                .describe('Client registration settings'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                client_id: { type: 'string' },
+                client_secret: { type: 'string' },
+                client_id_issued_at: { type: 'number' },
+                client_secret_expires_at: { type: 'number' },
+            },
+            description: 'Registered client details with credentials',
+        },
+    },
+    {
+        name: 'ebay_get_signing_keys',
+        description: 'Get all signing keys for the application. Returns public keys and metadata (private keys are not stored by eBay).',
+        inputSchema: {},
+        outputSchema: {
+            type: 'object',
+            properties: {
+                signingKeys: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            signingKeyId: { type: 'string' },
+                            signingKeyCipher: { type: 'string' },
+                            publicKey: { type: 'string' },
+                            jwe: { type: 'string' },
+                            creationTime: { type: 'number' },
+                            expirationTime: { type: 'number' },
+                        },
+                    },
+                },
+            },
+            description: 'List of signing keys',
+        },
+    },
+    {
+        name: 'ebay_create_signing_key',
+        description: 'Create a new signing keypair for API digital signatures. Supports ED25519 (recommended) or RSA ciphers. IMPORTANT: Save the private key immediately as eBay does not store it.',
+        inputSchema: {
+            signingKeyCipher: z
+                .enum(['ED25519', 'RSA'])
+                .optional()
+                .describe('Cipher to use for keypair: ED25519 (recommended, shorter keys) or RSA (legacy support)'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                signingKeyId: { type: 'string' },
+                signingKeyCipher: { type: 'string' },
+                privateKey: { type: 'string' },
+                publicKey: { type: 'string' },
+                jwe: { type: 'string' },
+                creationTime: { type: 'number' },
+                expirationTime: { type: 'number' },
+            },
+            description: 'Created signing key with private key (returned only once)',
+        },
+    },
+    {
+        name: 'ebay_get_signing_key',
+        description: 'Get a specific signing key by ID. Returns public key and metadata (private key is not stored by eBay).',
+        inputSchema: {
+            signingKeyId: z.string().describe('The system-generated eBay ID of the signing key'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                signingKeyId: { type: 'string' },
+                signingKeyCipher: { type: 'string' },
+                publicKey: { type: 'string' },
+                jwe: { type: 'string' },
+                creationTime: { type: 'number' },
+                expirationTime: { type: 'number' },
+            },
+            description: 'Signing key details',
+        },
+    },
+];