ebay-mcp 1.4.3

package/build/schemas/account-management/account.js

@@ -0,0 +1,366 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { TimeDurationUnit, RegionType, ShippingCostType, ShippingOptionType, RefundMethod, ReturnMethod, ReturnShippingCostPayer, MarketplaceId, } from '../../types/ebay-enums.js';
+/**
+ * Account Management API Schemas
+ *
+ * This file contains Zod schemas for all Account Management endpoints.
+ * Schemas are organized by endpoint and include both input and output validation.
+ */
+// ============================================================================
+// Common/Shared Response Schemas
+// ============================================================================
+const errorSchema = z.object({
+    errorId: z.number().optional(),
+    domain: z.string().optional(),
+    category: z.string().optional(),
+    message: z.string().optional(),
+    longMessage: z.string().optional(),
+    parameters: z.array(z.object({
+        name: z.string().optional(),
+        value: z.string().optional(),
+    })).optional(),
+});
+const timeDurationSchema = z.object({
+    unit: z.nativeEnum(TimeDurationUnit).optional(),
+    value: z.number().optional(),
+});
+const amountSchema = z.object({
+    currency: z.string().optional(),
+    value: z.string().optional(),
+});
+const regionSchema = z.object({
+    regionName: z.string().optional(),
+    regionType: z.nativeEnum(RegionType).optional(),
+});
+const regionSetSchema = z.object({
+    regionIncluded: z.array(regionSchema).optional(),
+    regionExcluded: z.array(regionSchema).optional(),
+});
+// ============================================================================
+// Custom Policy Schemas
+// ============================================================================
+// Input
+export const getCustomPoliciesInputSchema = z.object({
+    policyTypes: z.string().optional()
+        .describe('Comma-delimited list of policy types to retrieve (e.g., PRODUCT_COMPLIANCE, TAKE_BACK)'),
+});
+// Output
+export const customPolicySchema = z.object({
+    customPolicyId: z.string().optional(),
+    label: z.string().optional(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    policyType: z.string().optional(),
+});
+export const customPolicyResponseSchema = z.object({
+    customPolicies: z.array(customPolicySchema).optional(),
+    href: z.string().optional(),
+    limit: z.number().optional(),
+    next: z.string().optional(),
+    offset: z.number().optional(),
+    prev: z.string().optional(),
+    total: z.number().optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+export const createCustomPolicyInputSchema = z.object({
+    policy: z.object({
+        name: z.string(),
+        description: z.string().optional(),
+        policyType: z.string(),
+        label: z.string().optional(),
+    }),
+});
+export const createCustomPolicyOutputSchema = customPolicySchema;
+// ============================================================================
+// Fulfillment Policy Schemas
+// ============================================================================
+const categoryTypeSchema = z.object({
+    name: z.string().optional(),
+    default: z.boolean().optional(),
+});
+const shippingServiceSchema = z.object({
+    additionalShippingCost: amountSchema.optional(),
+    buyerResponsibleForPickup: z.boolean().optional(),
+    buyerResponsibleForShipping: z.boolean().optional(),
+    freeShipping: z.boolean().optional(),
+    shippingCarrierCode: z.string().optional(),
+    shippingCost: amountSchema.optional(),
+    shippingServiceCode: z.string().optional(),
+    shipToLocations: regionSetSchema.optional(),
+    sortOrder: z.number().optional(),
+    surcharge: amountSchema.optional(), // DEPRECATED but still in API
+});
+const shippingOptionSchema = z.object({
+    costType: z.nativeEnum(ShippingCostType).optional(),
+    optionType: z.nativeEnum(ShippingOptionType).optional(),
+    insuranceFee: amountSchema.optional(), // DEPRECATED but in API
+    insuranceOffered: z.boolean().optional(), // DEPRECATED but in API
+    packageHandlingCost: amountSchema.optional(),
+    rateTableId: z.string().optional(),
+    shippingDiscountProfileId: z.string().optional(),
+    shippingPromotionOffered: z.boolean().optional(),
+    shippingServices: z.array(shippingServiceSchema).optional(),
+});
+export const fulfillmentPolicySchema = z.object({
+    name: z.string(),
+    marketplaceId: z.nativeEnum(MarketplaceId),
+    categoryTypes: z.array(categoryTypeSchema).optional(),
+    description: z.string().optional(),
+    freightShipping: z.boolean().optional(),
+    globalShipping: z.boolean().optional(),
+    handlingTime: timeDurationSchema.optional(),
+    localPickup: z.boolean().optional(),
+    pickupDropOff: z.boolean().optional(),
+    shippingOptions: z.array(shippingOptionSchema).optional(),
+    shipToLocations: regionSetSchema.optional(),
+});
+export const fulfillmentPolicyResponseSchema = z.object({
+    fulfillmentPolicyId: z.string().optional(),
+    categoryTypes: z.array(categoryTypeSchema).optional(),
+    description: z.string().optional(),
+    freightShipping: z.boolean().optional(),
+    globalShipping: z.boolean().optional(),
+    handlingTime: timeDurationSchema.optional(),
+    localPickup: z.boolean().optional(),
+    marketplaceId: z.string().optional(),
+    name: z.string().optional(),
+    pickupDropOff: z.boolean().optional(),
+    shippingOptions: z.array(shippingOptionSchema).optional(),
+    shipToLocations: regionSetSchema.optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+export const getFulfillmentPoliciesInputSchema = z.object({
+    marketplaceId: z.nativeEnum(MarketplaceId)
+        .describe('eBay marketplace ID (e.g., EBAY_US)'),
+});
+export const getFulfillmentPoliciesOutputSchema = z.object({
+    fulfillmentPolicies: z.array(fulfillmentPolicyResponseSchema).optional(),
+    href: z.string().optional(),
+    limit: z.number().optional(),
+    next: z.string().optional(),
+    offset: z.number().optional(),
+    prev: z.string().optional(),
+    total: z.number().optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+export const createFulfillmentPolicyInputSchema = z.object({
+    policy: fulfillmentPolicySchema,
+});
+export const createFulfillmentPolicyOutputSchema = z.object({
+    fulfillmentPolicyId: z.string().optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+// ============================================================================
+// Payment Policy Schemas
+// ============================================================================
+const paymentMethodSchema = z.object({
+    paymentMethodType: z.string().optional(),
+    brands: z.array(z.string()).optional(), // DEPRECATED
+    recipientAccountReference: z.object({
+        referenceId: z.string().optional(),
+        referenceType: z.string().optional(),
+    }).optional(), // DEPRECATED
+});
+const depositSchema = z.object({
+    amount: amountSchema.optional(), // Fixed from depositAmount
+    dueIn: timeDurationSchema.optional(),
+    paymentMethods: z.array(paymentMethodSchema).optional(), // DEPRECATED but in API
+});
+export const paymentPolicySchema = z.object({
+    name: z.string(),
+    marketplaceId: z.nativeEnum(MarketplaceId),
+    categoryTypes: z.array(categoryTypeSchema).optional(),
+    description: z.string().optional(),
+    deposit: depositSchema.optional(),
+    fullPaymentDueIn: timeDurationSchema.optional(),
+    immediatePay: z.boolean().optional(),
+    paymentInstructions: z.string().optional(),
+    paymentMethods: z.array(paymentMethodSchema).optional(),
+});
+export const paymentPolicyResponseSchema = z.object({
+    paymentPolicyId: z.string().optional(),
+    categoryTypes: z.array(categoryTypeSchema).optional(),
+    deposit: depositSchema.optional(),
+    description: z.string().optional(),
+    fullPaymentDueIn: timeDurationSchema.optional(),
+    immediatePay: z.boolean().optional(),
+    marketplaceId: z.string().optional(),
+    name: z.string().optional(),
+    paymentInstructions: z.string().optional(),
+    paymentMethods: z.array(paymentMethodSchema).optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+export const getPaymentPoliciesInputSchema = z.object({
+    marketplaceId: z.nativeEnum(MarketplaceId)
+        .describe('eBay marketplace ID'),
+});
+export const getPaymentPoliciesOutputSchema = z.object({
+    paymentPolicies: z.array(paymentPolicyResponseSchema).optional(),
+    href: z.string().optional(),
+    limit: z.number().optional(),
+    next: z.string().optional(),
+    offset: z.number().optional(),
+    prev: z.string().optional(),
+    total: z.number().optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+export const createPaymentPolicyInputSchema = z.object({
+    policy: paymentPolicySchema,
+});
+export const createPaymentPolicyOutputSchema = z.object({
+    paymentPolicyId: z.string().optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+// ============================================================================
+// Return Policy Schemas
+// ============================================================================
+export const returnPolicySchema = z.object({
+    name: z.string(),
+    marketplaceId: z.nativeEnum(MarketplaceId),
+    categoryTypes: z.array(categoryTypeSchema).optional(),
+    description: z.string().optional(),
+    extendedHolidayReturnsOffered: z.boolean().optional(),
+    refundMethod: z.nativeEnum(RefundMethod).optional(),
+    restockingFeePercentage: z.string().optional(),
+    returnInstructions: z.string().optional(),
+    returnMethod: z.nativeEnum(ReturnMethod).optional(),
+    returnPeriod: timeDurationSchema.optional(),
+    returnsAccepted: z.boolean().optional(),
+    returnShippingCostPayer: z.nativeEnum(ReturnShippingCostPayer).optional(),
+});
+export const returnPolicyResponseSchema = z.object({
+    returnPolicyId: z.string().optional(),
+    categoryTypes: z.array(categoryTypeSchema).optional(),
+    description: z.string().optional(),
+    extendedHolidayReturnsOffered: z.boolean().optional(),
+    internationalOverride: z.object({
+        returnMethod: z.string().optional(),
+        returnPeriod: timeDurationSchema.optional(),
+        returnsAccepted: z.boolean().optional(),
+        returnShippingCostPayer: z.string().optional(),
+    }).optional(),
+    marketplaceId: z.string().optional(),
+    name: z.string().optional(),
+    refundMethod: z.string().optional(),
+    restockingFeePercentage: z.string().optional(), // DEPRECATED
+    returnInstructions: z.string().optional(),
+    returnMethod: z.string().optional(),
+    returnPeriod: timeDurationSchema.optional(),
+    returnsAccepted: z.boolean().optional(),
+    returnShippingCostPayer: z.string().optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+export const getReturnPoliciesInputSchema = z.object({
+    marketplaceId: z.nativeEnum(MarketplaceId)
+        .describe('eBay marketplace ID'),
+});
+export const getReturnPoliciesOutputSchema = z.object({
+    returnPolicies: z.array(returnPolicyResponseSchema).optional(),
+    href: z.string().optional(),
+    limit: z.number().optional(),
+    next: z.string().optional(),
+    offset: z.number().optional(),
+    prev: z.string().optional(),
+    total: z.number().optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+export const createReturnPolicyInputSchema = z.object({
+    policy: returnPolicySchema,
+});
+export const createReturnPolicyOutputSchema = z.object({
+    returnPolicyId: z.string().optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+// ============================================================================
+// Sales Tax Schemas
+// ============================================================================
+export const salesTaxBaseSchema = z.object({
+    salesTaxPercentage: z.string(),
+    shippingAndHandlingTaxed: z.boolean().optional(),
+});
+export const salesTaxSchema = z.object({
+    countryCode: z.string().optional(),
+    jurisdictionId: z.string().optional(),
+    salesTaxPercentage: z.string().optional(),
+    shippingAndHandlingTaxed: z.boolean().optional(),
+});
+export const getSalesTaxesOutputSchema = z.object({
+    salesTaxes: z.array(salesTaxSchema).optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+// ============================================================================
+// Program Schemas
+// ============================================================================
+export const programRequestSchema = z.object({
+    programType: z.string(),
+});
+export const programsOutputSchema = z.object({
+    programs: z.array(z.object({
+        programType: z.string().optional(),
+        programStatus: z.string().optional(),
+    })).optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+// ============================================================================
+// KYC Schemas
+// ============================================================================
+export const kycOutputSchema = z.object({
+    kycCheck: z.string().optional(),
+    detailedStatus: z.string().optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+// ============================================================================
+// Privileges Schemas
+// ============================================================================
+export const privilegesOutputSchema = z.object({
+    sellingLimit: z.object({
+        amount: amountSchema.optional(),
+        quantity: z.number().optional(),
+    }).optional(),
+    qualifiesForSelling: z.boolean().optional(),
+    sellerRegistrationCompleted: z.boolean().optional(),
+    warnings: z.array(errorSchema).optional(),
+});
+// ============================================================================
+// JSON Schema Conversion Functions
+// ============================================================================
+/**
+ * Convert Zod schemas to JSON Schema format for MCP tools
+ */
+export function getAccountManagementJsonSchemas() {
+    return {
+        // Custom Policies
+        getCustomPoliciesInput: zodToJsonSchema(getCustomPoliciesInputSchema, 'getCustomPoliciesInput'),
+        getCustomPoliciesOutput: zodToJsonSchema(customPolicyResponseSchema, 'getCustomPoliciesOutput'),
+        createCustomPolicyInput: zodToJsonSchema(createCustomPolicyInputSchema, 'createCustomPolicyInput'),
+        createCustomPolicyOutput: zodToJsonSchema(createCustomPolicyOutputSchema, 'createCustomPolicyOutput'),
+        // Fulfillment Policies
+        getFulfillmentPoliciesInput: zodToJsonSchema(getFulfillmentPoliciesInputSchema, 'getFulfillmentPoliciesInput'),
+        getFulfillmentPoliciesOutput: zodToJsonSchema(getFulfillmentPoliciesOutputSchema, 'getFulfillmentPoliciesOutput'),
+        createFulfillmentPolicyInput: zodToJsonSchema(createFulfillmentPolicyInputSchema, 'createFulfillmentPolicyInput'),
+        createFulfillmentPolicyOutput: zodToJsonSchema(createFulfillmentPolicyOutputSchema, 'createFulfillmentPolicyOutput'),
+        fulfillmentPolicyDetails: zodToJsonSchema(fulfillmentPolicyResponseSchema, 'fulfillmentPolicyDetails'),
+        // Payment Policies
+        getPaymentPoliciesInput: zodToJsonSchema(getPaymentPoliciesInputSchema, 'getPaymentPoliciesInput'),
+        getPaymentPoliciesOutput: zodToJsonSchema(getPaymentPoliciesOutputSchema, 'getPaymentPoliciesOutput'),
+        createPaymentPolicyInput: zodToJsonSchema(createPaymentPolicyInputSchema, 'createPaymentPolicyInput'),
+        createPaymentPolicyOutput: zodToJsonSchema(createPaymentPolicyOutputSchema, 'createPaymentPolicyOutput'),
+        paymentPolicyDetails: zodToJsonSchema(paymentPolicyResponseSchema, 'paymentPolicyDetails'),
+        // Return Policies
+        getReturnPoliciesInput: zodToJsonSchema(getReturnPoliciesInputSchema, 'getReturnPoliciesInput'),
+        getReturnPoliciesOutput: zodToJsonSchema(getReturnPoliciesOutputSchema, 'getReturnPoliciesOutput'),
+        createReturnPolicyInput: zodToJsonSchema(createReturnPolicyInputSchema, 'createReturnPolicyInput'),
+        createReturnPolicyOutput: zodToJsonSchema(createReturnPolicyOutputSchema, 'createReturnPolicyOutput'),
+        returnPolicyDetails: zodToJsonSchema(returnPolicyResponseSchema, 'returnPolicyDetails'),
+        // Sales Tax
+        getSalesTaxesOutput: zodToJsonSchema(getSalesTaxesOutputSchema, 'getSalesTaxesOutput'),
+        salesTaxDetails: zodToJsonSchema(salesTaxSchema, 'salesTaxDetails'),
+        // Programs
+        programRequest: zodToJsonSchema(programRequestSchema, 'programRequest'),
+        programsOutput: zodToJsonSchema(programsOutputSchema, 'programsOutput'),
+        // KYC & Privileges
+        kycOutput: zodToJsonSchema(kycOutputSchema, 'kycOutput'),
+        privilegesOutput: zodToJsonSchema(privilegesOutputSchema, 'privilegesOutput'),
+    };
+}

package/build/schemas/analytics/analytics.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Convert Zod schemas to JSON Schema format for MCP tools
+ */
+export declare function getAnalyticsJsonSchemas(): {
+    getCustomerServiceMetricInput: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    getCustomerServiceMetricOutput: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    findSellerStandardsProfilesOutput: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    getSellerStandardsProfileInput: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    getSellerStandardsProfileOutput: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    getTrafficReportInput: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    getTrafficReportOutput: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    benchmarkMetadata: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    cycle: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    definition: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    dimension: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    dimensionMetric: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    distribution: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    error: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    errorParameter: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    evaluationCycle: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    header: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    metadata: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    metadataHeader: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    metadataRecord: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    metric: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    metricBenchmark: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    metricDistribution: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    record: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    report: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    standardsProfile: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    value: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};