ebay-mcp 1.18.0 → 1.18.2

package/build/schemas/metadata/metadata.js

@@ -1,9 +1,8 @@
-import { z } from '../../utils/effectSchema.js';
-import { zodToJsonSchema } from 'zod-to-json-schema';
+import { z } from 'zod';
 /**
  * Metadata API Schemas
  *
- * This file contains Effect-backed schemas for all Metadata API endpoints.
+ * This file contains Zod schemas for all Metadata API endpoints.
  * Schemas are organized by endpoint and include both input and output validation.
  */
 // ============================================================================
@@ -747,90 +746,3 @@ export const salesTaxJurisdictionsSchema = z.object({
 // ============================================================================
 // JSON Schema Conversion Function
 // ============================================================================
-/**
- * Generates JSON schemas for all Metadata API endpoints.
- *
- * @returns Metadata API JSON schemas keyed by endpoint or shared model name.
- * @example
- * ```ts
- * const schemas = getMetadataJsonSchemas();
- * ```
- */
-export const getMetadataJsonSchemas = () => {
-    return {
-        // Marketplace Policies
-        automotivePartsCompatibilityPolicy: zodToJsonSchema(automotivePartsCompatibilityPolicySchema, 'automotivePartsCompatibilityPolicy'),
-        automotivePartsCompatibilityPolicyResponse: zodToJsonSchema(automotivePartsCompatibilityPolicyResponseSchema, 'automotivePartsCompatibilityPolicyResponse'),
-        categoryPolicy: zodToJsonSchema(categoryPolicySchema, 'categoryPolicy'),
-        categoryPolicyResponse: zodToJsonSchema(categoryPolicyResponseSchema, 'categoryPolicyResponse'),
-        classifiedAdPolicy: zodToJsonSchema(classifiedAdPolicySchema, 'classifiedAdPolicy'),
-        classifiedAdPolicyResponse: zodToJsonSchema(classifiedAdPolicyResponseSchema, 'classifiedAdPolicyResponse'),
-        currency: zodToJsonSchema(currencySchema, 'currency'),
-        getCurrenciesResponse: zodToJsonSchema(getCurrenciesResponseSchema, 'getCurrenciesResponse'),
-        extendedProducerResponsibility: zodToJsonSchema(extendedProducerResponsibilitySchema, 'extendedProducerResponsibility'),
-        extendedProducerResponsibilityPolicy: zodToJsonSchema(extendedProducerResponsibilityPolicySchema, 'extendedProducerResponsibilityPolicy'),
-        extendedProducerResponsibilityPolicyResponse: zodToJsonSchema(extendedProducerResponsibilityPolicyResponseSchema, 'extendedProducerResponsibilityPolicyResponse'),
-        signalWord: zodToJsonSchema(signalWordSchema, 'signalWord'),
-        hazardStatement: zodToJsonSchema(hazardStatementSchema, 'hazardStatement'),
-        pictogram: zodToJsonSchema(pictogramSchema, 'pictogram'),
-        hazardousMaterialDetailsResponse: zodToJsonSchema(hazardousMaterialDetailsResponseSchema, 'hazardousMaterialDetailsResponse'),
-        itemCondition: zodToJsonSchema(itemConditionSchema, 'itemCondition'),
-        itemConditionDescriptor: zodToJsonSchema(itemConditionDescriptorSchema, 'itemConditionDescriptor'),
-        itemConditionDescriptorConstraint: zodToJsonSchema(itemConditionDescriptorConstraintSchema, 'itemConditionDescriptorConstraint'),
-        itemConditionDescriptorValue: zodToJsonSchema(itemConditionDescriptorValueSchema, 'itemConditionDescriptorValue'),
-        itemConditionDescriptorValueConstraint: zodToJsonSchema(itemConditionDescriptorValueConstraintSchema, 'itemConditionDescriptorValueConstraint'),
-        itemConditionPolicy: zodToJsonSchema(itemConditionPolicySchema, 'itemConditionPolicy'),
-        itemConditionPolicyResponse: zodToJsonSchema(itemConditionPolicyResponseSchema, 'itemConditionPolicyResponse'),
-        listingStructurePolicy: zodToJsonSchema(listingStructurePolicySchema, 'listingStructurePolicy'),
-        listingStructurePolicyResponse: zodToJsonSchema(listingStructurePolicyResponseSchema, 'listingStructurePolicyResponse'),
-        listingDuration: zodToJsonSchema(listingDurationSchema, 'listingDuration'),
-        listingTypePolicy: zodToJsonSchema(listingTypePolicySchema, 'listingTypePolicy'),
-        listingTypePoliciesResponse: zodToJsonSchema(listingTypePoliciesResponseSchema, 'listingTypePoliciesResponse'),
-        localListingDistance: zodToJsonSchema(localListingDistanceSchema, 'localListingDistance'),
-        motorsListingPolicy: zodToJsonSchema(motorsListingPolicySchema, 'motorsListingPolicy'),
-        motorsListingPoliciesResponse: zodToJsonSchema(motorsListingPoliciesResponseSchema, 'motorsListingPoliciesResponse'),
-        negotiatedPricePolicy: zodToJsonSchema(negotiatedPricePolicySchema, 'negotiatedPricePolicy'),
-        negotiatedPricePolicyResponse: zodToJsonSchema(negotiatedPricePolicyResponseSchema, 'negotiatedPricePolicyResponse'),
-        productSafetyLabelPictogram: zodToJsonSchema(productSafetyLabelPictogramSchema, 'productSafetyLabelPictogram'),
-        productSafetyLabelStatement: zodToJsonSchema(productSafetyLabelStatementSchema, 'productSafetyLabelStatement'),
-        productSafetyLabelsResponse: zodToJsonSchema(productSafetyLabelsResponseSchema, 'productSafetyLabelsResponse'),
-        regulatoryAttribute: zodToJsonSchema(regulatoryAttributeSchema, 'regulatoryAttribute'),
-        regulatoryPolicy: zodToJsonSchema(regulatoryPolicySchema, 'regulatoryPolicy'),
-        regulatoryPolicyResponse: zodToJsonSchema(regulatoryPolicyResponseSchema, 'regulatoryPolicyResponse'),
-        returnPolicyDetails: zodToJsonSchema(returnPolicyDetailsSchema, 'returnPolicyDetails'),
-        returnPolicy: zodToJsonSchema(returnPolicyMetadataSchema, 'returnPolicy'),
-        returnPolicyResponse: zodToJsonSchema(returnPolicyMetadataResponseSchema, 'returnPolicyResponse'),
-        shippingPolicy: zodToJsonSchema(shippingPolicySchema, 'shippingPolicy'),
-        shippingPoliciesResponse: zodToJsonSchema(shippingPoliciesResponseSchema, 'shippingPoliciesResponse'),
-        siteVisibilityPolicy: zodToJsonSchema(siteVisibilityPolicySchema, 'siteVisibilityPolicy'),
-        siteVisibilityPoliciesResponse: zodToJsonSchema(siteVisibilityPoliciesResponseSchema, 'siteVisibilityPoliciesResponse'),
-        // Compatibility Schemas
-        propertyFilterInner: zodToJsonSchema(propertyFilterInnerSchema, 'propertyFilterInner'),
-        compatibilityDetails: zodToJsonSchema(compatibilityDetailsSchema, 'compatibilityDetails'),
-        compatibility: zodToJsonSchema(compatibilitySchema, 'compatibility'),
-        specificationRequest: zodToJsonSchema(specificationRequestSchema, 'specificationRequest'),
-        specificationResponse: zodToJsonSchema(specificationResponseSchema, 'specificationResponse'),
-        propertyNamesRequest: zodToJsonSchema(propertyNamesRequestSchema, 'propertyNamesRequest'),
-        propertyNamesResponse: zodToJsonSchema(propertyNamesResponseSchema, 'propertyNamesResponse'),
-        propertyValuesRequest: zodToJsonSchema(propertyValuesRequestSchema, 'propertyValuesRequest'),
-        propertyValuesResponse: zodToJsonSchema(propertyValuesResponseSchema, 'propertyValuesResponse'),
-        multiCompatibilityPropertyValuesRequest: zodToJsonSchema(multiCompatibilityPropertyValuesRequestSchema, 'multiCompatibilityPropertyValuesRequest'),
-        multiCompatibilityPropertyValuesResponse: zodToJsonSchema(multiCompatibilityPropertyValuesResponseSchema, 'multiCompatibilityPropertyValuesResponse'),
-        disabledProductFilter: zodToJsonSchema(disabledProductFilterSchema, 'disabledProductFilter'),
-        productIdentifier: zodToJsonSchema(productIdentifierSchema, 'productIdentifier'),
-        productRequest: zodToJsonSchema(productRequestSchema, 'productRequest'),
-        productResponse: zodToJsonSchema(productResponseSchema, 'productResponse'),
-        // Sales Tax Jurisdictions
-        salesTaxJurisdiction: zodToJsonSchema(salesTaxJurisdictionSchema, 'salesTaxJurisdiction'),
-        salesTaxJurisdictions: zodToJsonSchema(salesTaxJurisdictionsSchema, 'salesTaxJurisdictions'),
-        // Common Schemas
-        pagination: zodToJsonSchema(paginationSchema, 'pagination'),
-        paginationInput: zodToJsonSchema(paginationInputSchema, 'paginationInput'),
-        sortOrderInner: zodToJsonSchema(sortOrderInnerSchema, 'sortOrderInner'),
-        sortOrderProperties: zodToJsonSchema(sortOrderPropertiesSchema, 'sortOrderProperties'),
-        error: zodToJsonSchema(errorSchema, 'error'),
-        errorParameter: zodToJsonSchema(errorParameterSchema, 'errorParameter'),
-        amount: zodToJsonSchema(amountSchema, 'amount'),
-        timeDuration: zodToJsonSchema(timeDurationSchema, 'timeDuration'),
-    };
-};

package/build/schemas/metadata/shipping.js

@@ -1,5 +1,5 @@
 import { MarketplaceId } from '../../types/ebayEnums.js';
-import { z } from '../../utils/effectSchema.js';
+import { z } from 'zod';
 /**
  * Input shared by the five Metadata API `shipping:marketplace` methods (carriers, services,
  * locations, excluded locations, and handling times): one path parameter and one header.

package/build/schemas/other/browse.js

@@ -1,8 +1,8 @@
-import { z } from '../../utils/effectSchema.js';
+import { z } from 'zod';
 /**
  * Browse API Schemas
  *
- * Effect-backed input schemas for active-listing marketplace search tools.
+ * Zod input schemas for active-listing marketplace search tools.
  */
 /**
  * Validates input for ebay_find_active_items (Browse item_summary/search).

package/build/schemas/other/finding.js

@@ -1,8 +1,8 @@
-import { z } from '../../utils/effectSchema.js';
+import { z } from 'zod';
 /**
  * Finding API Schemas
  *
- * Effect-backed input schemas for sold/completed listing search tools.
+ * Zod input schemas for sold/completed listing search tools.
  */
 /**
  * Validates input for ebay_find_completed_items (Finding API findCompletedItems).

package/build/schemas/other/otherApis.js

@@ -1,9 +1,8 @@
-import { z } from '../../utils/effectSchema.js';
-import { zodToJsonSchema } from 'zod-to-json-schema';
+import { z } from 'zod';
 /**
  * Other eBay APIs Schemas
  *
- * This file contains Effect-backed schemas for various eBay APIs including:
+ * This file contains Zod schemas for various eBay APIs including:
  * - Commerce Identity API
  * - Sell Compliance API
  * - Commerce Translation API
@@ -311,114 +310,3 @@ export const getVeroReasonCodesInputSchema = z.object({});
 // ============================================================================
 // JSON Schema Conversion Functions
 // ============================================================================
-/**
- * Converts other eBay API Effect-backed schemas to JSON Schema format for MCP tools.
- *
- * @returns Other API JSON schemas keyed by endpoint or shared model name.
- * @example
- * ```ts
- * const schemas = getOtherApisJsonSchemas();
- * ```
- */
-export const getOtherApisJsonSchemas = () => {
-    return {
-        // Commerce Identity API
-        getUserInput: zodToJsonSchema(getUserInputSchema, 'getUserInput'),
-        getUserConsentOutput: zodToJsonSchema(getUserConsentResponseSchema, 'getUserConsentOutput'),
-        // Sell Compliance API
-        getComplianceSummaryOutput: zodToJsonSchema(complianceSummaryInfoSchema, 'getComplianceSummaryOutput'),
-        getListingViolationsInput: zodToJsonSchema(getListingViolationsInputSchema, 'getListingViolationsInput'),
-        getListingViolationsOutput: zodToJsonSchema(listingViolationSummaryResponseSchema, 'getListingViolationsOutput'),
-        getListingViolationsSummaryInput: zodToJsonSchema(getListingViolationsSummaryInputSchema, 'getListingViolationsSummaryInput'),
-        // Commerce Translation API
-        translateInput: zodToJsonSchema(translateInputSchema, 'translateInput'),
-        translateOutput: zodToJsonSchema(translateResponseSchema, 'translateOutput'),
-        // Commerce VERO API
-        createVeroReportInput: zodToJsonSchema(createVeroReportInputSchema, 'createVeroReportInput'),
-        createVeroReportOutput: zodToJsonSchema(veroReportItemsResponseSchema, 'createVeroReportOutput'),
-        getVeroReportInput: zodToJsonSchema(getVeroReportInputSchema, 'getVeroReportInput'),
-        getVeroReportOutput: zodToJsonSchema(veroReportStatusResponseSchema, 'getVeroReportOutput'),
-        getVeroReportItemsInput: zodToJsonSchema(getVeroReportItemsInputSchema, 'getVeroReportItemsInput'),
-        getVeroReportItemsOutput: zodToJsonSchema(veroReportItemsStatusResponseSchema, 'getVeroReportItemsOutput'),
-        getVeroReasonCodeInput: zodToJsonSchema(getVeroReasonCodeInputSchema, 'getVeroReasonCodeInput'),
-        getVeroReasonCodeOutput: zodToJsonSchema(veroReasonCodeResponseSchema, 'getVeroReasonCodeOutput'),
-        getVeroReasonCodesInput: zodToJsonSchema(getVeroReasonCodesInputSchema, 'getVeroReasonCodesInput'),
-        getVeroReasonCodesOutput: zodToJsonSchema(veroReasonCodesResponseSchema, 'getVeroReasonCodesOutput'),
-        // Sell eDelivery International Shipping API
-        getActualCostsInput: zodToJsonSchema(getActualCostsInputSchema, 'getActualCostsInput'),
-        getActualCostsOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getActualCostsOutput'),
-        getAddressPreferencesInput: zodToJsonSchema(getAddressPreferencesInputSchema, 'getAddressPreferencesInput'),
-        getAddressPreferencesOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getAddressPreferencesOutput'),
-        createAddressPreferenceInput: zodToJsonSchema(edeliveryBodyInputSchema, 'createAddressPreferenceInput'),
-        createAddressPreferenceOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'createAddressPreferenceOutput'),
-        getConsignPreferencesOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getConsignPreferencesOutput'),
-        getConsignPreferencesInput: zodToJsonSchema(getConsignPreferencesInputSchema, 'getConsignPreferencesInput'),
-        createConsignPreferenceInput: zodToJsonSchema(edeliveryBodyInputSchema, 'createConsignPreferenceInput'),
-        createConsignPreferenceOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'createConsignPreferenceOutput'),
-        getAgentsInput: zodToJsonSchema(edeliveryPaginationInputSchema, 'getAgentsInput'),
-        getAgentsOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getAgentsOutput'),
-        getBatteryQualificationsInput: zodToJsonSchema(edeliveryPaginationInputSchema, 'getBatteryQualificationsInput'),
-        getBatteryQualificationsOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getBatteryQualificationsOutput'),
-        getDropoffSitesInput: zodToJsonSchema(edeliveryPaginationInputSchema, 'getDropoffSitesInput'),
-        getDropoffSitesOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getDropoffSitesOutput'),
-        getServicesInput: zodToJsonSchema(edeliveryPaginationInputSchema, 'getServicesInput'),
-        getServicesOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getServicesOutput'),
-        createBundleInput: zodToJsonSchema(edeliveryBodyInputSchema, 'createBundleInput'),
-        createBundleOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'createBundleOutput'),
-        getBundleInput: zodToJsonSchema(bundleIdInputSchema, 'getBundleInput'),
-        getBundleOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getBundleOutput'),
-        cancelBundleInput: zodToJsonSchema(bundleIdInputSchema, 'cancelBundleInput'),
-        cancelBundleOutput: zodToJsonSchema(emptyResponseSchema, 'cancelBundleOutput'),
-        getBundleLabelInput: zodToJsonSchema(bundleIdInputSchema, 'getBundleLabelInput'),
-        getBundleLabelOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getBundleLabelOutput'),
-        createPackageInput: zodToJsonSchema(edeliveryBodyInputSchema, 'createPackageInput'),
-        createPackageOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'createPackageOutput'),
-        getPackageInput: zodToJsonSchema(packageIdInputSchema, 'getPackageInput'),
-        getPackageOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getPackageOutput'),
-        deletePackageInput: zodToJsonSchema(packageIdInputSchema, 'deletePackageInput'),
-        deletePackageOutput: zodToJsonSchema(emptyResponseSchema, 'deletePackageOutput'),
-        getPackagesByLineItemIdInput: zodToJsonSchema(getPackagesByLineItemIdInputSchema, 'getPackagesByLineItemIdInput'),
-        getPackagesByLineItemIdOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getPackagesByLineItemIdOutput'),
-        cancelPackageInput: zodToJsonSchema(packageIdInputSchema, 'cancelPackageInput'),
-        cancelPackageOutput: zodToJsonSchema(emptyResponseSchema, 'cancelPackageOutput'),
-        clonePackageInput: zodToJsonSchema(packageIdInputSchema, 'clonePackageInput'),
-        clonePackageOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'clonePackageOutput'),
-        confirmPackageInput: zodToJsonSchema(packageIdInputSchema, 'confirmPackageInput'),
-        confirmPackageOutput: zodToJsonSchema(emptyResponseSchema, 'confirmPackageOutput'),
-        bulkCancelPackagesInput: zodToJsonSchema(edeliveryBodyInputSchema, 'bulkCancelPackagesInput'),
-        bulkCancelPackagesOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'bulkCancelPackagesOutput'),
-        bulkConfirmPackagesInput: zodToJsonSchema(edeliveryBodyInputSchema, 'bulkConfirmPackagesInput'),
-        bulkConfirmPackagesOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'bulkConfirmPackagesOutput'),
-        bulkDeletePackagesInput: zodToJsonSchema(edeliveryBodyInputSchema, 'bulkDeletePackagesInput'),
-        bulkDeletePackagesOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'bulkDeletePackagesOutput'),
-        getLabelsInput: zodToJsonSchema(getLabelsInputSchema, 'getLabelsInput'),
-        getLabelsOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getLabelsOutput'),
-        getHandoverSheetInput: zodToJsonSchema(getHandoverSheetInputSchema, 'getHandoverSheetInput'),
-        getHandoverSheetOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getHandoverSheetOutput'),
-        getTrackingInput: zodToJsonSchema(getTrackingInputSchema, 'getTrackingInput'),
-        getTrackingOutput: zodToJsonSchema(generatedEDeliveryResponseSchema, 'getTrackingOutput'),
-        createComplaintInput: zodToJsonSchema(edeliveryBodyInputSchema, 'createComplaintInput'),
-        createComplaintOutput: zodToJsonSchema(emptyResponseSchema, 'createComplaintOutput'),
-        // Common Types
-        error: zodToJsonSchema(errorSchema, 'error'),
-        errorParameter: zodToJsonSchema(errorParameterSchema, 'errorParameter'),
-        amount: zodToJsonSchema(amountSchema, 'amount'),
-        address: zodToJsonSchema(addressSchema, 'address'),
-        contact: zodToJsonSchema(contactSchema, 'contact'),
-        dimensions: zodToJsonSchema(dimensionsSchema, 'dimensions'),
-        weight: zodToJsonSchema(weightSchema, 'weight'),
-        pageMetadata: zodToJsonSchema(pageMetadataSchema, 'pageMetadata'),
-        // Compliance Types
-        complianceViolation: zodToJsonSchema(complianceViolationSchema, 'complianceViolation'),
-        complianceDetail: zodToJsonSchema(complianceDetailSchema, 'complianceDetail'),
-        correctiveRecommendations: zodToJsonSchema(correctiveRecommendationsSchema, 'correctiveRecommendations'),
-        variationDetails: zodToJsonSchema(variationDetailsSchema, 'variationDetails'),
-        nameValueList: zodToJsonSchema(nameValueListSchema, 'nameValueList'),
-        // Translation Types
-        translation: zodToJsonSchema(translationSchema, 'translation'),
-        // VERO Types
-        reportedItem: zodToJsonSchema(reportedItemSchema, 'reportedItem'),
-        reportItemDetails: zodToJsonSchema(reportItemDetailsSchema, 'reportItemDetails'),
-        userConsent: zodToJsonSchema(userConsentSchema, 'userConsent'),
-    };
-};

package/build/schemas/taxonomy/categoryTree.js

@@ -1,4 +1,4 @@
-import { z } from '../../utils/effectSchema.js';
+import { z } from 'zod';
 /** Input for Taxonomy API methods addressed only by category tree (fetchItemAspects, getExpiredCategories). */
 export const categoryTreeIdInputSchema = z.object({
     categoryTreeId: z

package/build/schemas/taxonomy/charity.js

@@ -1,4 +1,4 @@
-import { z } from '../../utils/effectSchema.js';
+import { z } from 'zod';
 /** Marketplace sent as the Charity API's required X-EBAY-C-MARKETPLACE-ID header. */
 const charityMarketplaceIdSchema = z
     .enum(['EBAY_US', 'EBAY_GB'])

package/build/schemas/taxonomy/taxonomy.js

@@ -1,9 +1,8 @@
-import { z } from '../../utils/effectSchema.js';
-import { zodToJsonSchema } from 'zod-to-json-schema';
+import { z } from 'zod';
 /**
  * Taxonomy/Metadata API Schemas
  *
- * This file contains Effect-backed schemas for the Sell Metadata API (Taxonomy section).
+ * This file contains Zod schemas for the Sell Metadata API (Taxonomy section).
  * Schemas are organized by policy type and include category-related metadata.
  */
 // ============================================================================
@@ -513,69 +512,3 @@ const specificationRequestSchema = z.object({
 // ============================================================================
 // JSON Schema Conversion Functions
 // ============================================================================
-/**
- * Converts Taxonomy API Effect-backed schemas to JSON Schema format for MCP tools.
- *
- * @returns Taxonomy API JSON schemas keyed by endpoint or shared model name.
- * @example
- * ```ts
- * const schemas = getTaxonomyJsonSchemas();
- * ```
- */
-export const getTaxonomyJsonSchemas = () => {
-    return {
-        // Category Policies
-        getCategoryPoliciesOutput: zodToJsonSchema(categoryPolicyResponseSchema, 'getCategoryPoliciesOutput'),
-        // Item Condition Policies
-        getItemConditionPoliciesOutput: zodToJsonSchema(itemConditionPolicyResponseSchema, 'getItemConditionPoliciesOutput'),
-        // Return Policies
-        getReturnPoliciesOutput: zodToJsonSchema(returnPolicyResponseSchema, 'getReturnPoliciesOutput'),
-        // Listing Structure Policies
-        getListingStructurePoliciesOutput: zodToJsonSchema(listingStructurePolicyResponseSchema, 'getListingStructurePoliciesOutput'),
-        // Listing Type Policies
-        getListingTypePoliciesOutput: zodToJsonSchema(listingTypePoliciesResponseSchema, 'getListingTypePoliciesOutput'),
-        // Negotiated Price Policies
-        getNegotiatedPricePoliciesOutput: zodToJsonSchema(negotiatedPricePolicyResponseSchema, 'getNegotiatedPricePoliciesOutput'),
-        // Shipping Policies
-        getShippingPoliciesOutput: zodToJsonSchema(shippingPoliciesResponseSchema, 'getShippingPoliciesOutput'),
-        // Automotive Parts Compatibility Policies
-        getAutomotivePartsCompatibilityPoliciesOutput: zodToJsonSchema(automotivePartsCompatibilityPolicyResponseSchema, 'getAutomotivePartsCompatibilityPoliciesOutput'),
-        // Classified Ad Policies
-        getClassifiedAdPoliciesOutput: zodToJsonSchema(classifiedAdPolicyResponseSchema, 'getClassifiedAdPoliciesOutput'),
-        // Motors Listing Policies
-        getMotorsListingPoliciesOutput: zodToJsonSchema(motorsListingPoliciesResponseSchema, 'getMotorsListingPoliciesOutput'),
-        // Currencies
-        getCurrenciesOutput: zodToJsonSchema(getCurrenciesResponseSchema, 'getCurrenciesOutput'),
-        // Extended Producer Responsibility
-        getExtendedProducerResponsibilityPoliciesOutput: zodToJsonSchema(extendedProducerResponsibilityPolicyResponseSchema, 'getExtendedProducerResponsibilityPoliciesOutput'),
-        // Hazardous Materials Labels
-        getHazardousMaterialsLabelsOutput: zodToJsonSchema(hazardousMaterialDetailsResponseSchema, 'getHazardousMaterialsLabelsOutput'),
-        // Product Safety Labels
-        getProductSafetyLabelsOutput: zodToJsonSchema(productSafetyLabelsResponseSchema, 'getProductSafetyLabelsOutput'),
-        // Regulatory Policies
-        getRegulatoryPoliciesOutput: zodToJsonSchema(regulatoryPolicyResponseSchema, 'getRegulatoryPoliciesOutput'),
-        // Site Visibility Policies
-        getSiteVisibilityPoliciesOutput: zodToJsonSchema(siteVisibilityPoliciesResponseSchema, 'getSiteVisibilityPoliciesOutput'),
-        // Compatibility Methods
-        getCompatibilityPropertyNamesInput: zodToJsonSchema(propertyNamesRequestSchema, 'getCompatibilityPropertyNamesInput'),
-        getCompatibilityPropertyNamesOutput: zodToJsonSchema(propertyNamesResponseSchema, 'getCompatibilityPropertyNamesOutput'),
-        getCompatibilityPropertyValuesInput: zodToJsonSchema(propertyValuesRequestSchema, 'getCompatibilityPropertyValuesInput'),
-        getCompatibilityPropertyValuesOutput: zodToJsonSchema(propertyValuesResponseSchema, 'getCompatibilityPropertyValuesOutput'),
-        getMultiCompatibilityPropertyValuesInput: zodToJsonSchema(multiCompatibilityPropertyValuesRequestSchema, 'getMultiCompatibilityPropertyValuesInput'),
-        getMultiCompatibilityPropertyValuesOutput: zodToJsonSchema(multiCompatibilityPropertyValuesResponseSchema, 'getMultiCompatibilityPropertyValuesOutput'),
-        getProductCompatibilitiesInput: zodToJsonSchema(productRequestSchema, 'getProductCompatibilitiesInput'),
-        getProductCompatibilitiesOutput: zodToJsonSchema(productResponseSchema, 'getProductCompatibilitiesOutput'),
-        getCompatibilitiesBySpecificationInput: zodToJsonSchema(specificationRequestSchema, 'getCompatibilitiesBySpecificationInput'),
-        getCompatibilitiesBySpecificationOutput: zodToJsonSchema(specificationResponseSchema, 'getCompatibilitiesBySpecificationOutput'),
-        // Common Types
-        amount: zodToJsonSchema(amountSchema, 'amount'),
-        error: zodToJsonSchema(errorSchema, 'error'),
-        errorParameter: zodToJsonSchema(errorParameterSchema, 'errorParameter'),
-        timeDuration: zodToJsonSchema(timeDurationSchema, 'timeDuration'),
-        pagination: zodToJsonSchema(paginationSchema, 'pagination'),
-        compatibility: zodToJsonSchema(compatibilitySchema, 'compatibility'),
-        compatibilityDetails: zodToJsonSchema(compatibilityDetailsSchema, 'compatibilityDetails'),
-        propertyFilterInner: zodToJsonSchema(propertyFilterInnerSchema, 'propertyFilterInner'),
-        productIdentifier: zodToJsonSchema(productIdentifierSchema, 'productIdentifier'),
-    };
-};

package/build/scripts/autoSetup.js

@@ -340,7 +340,7 @@ function main() {
     // Step 2: Detect MCP clients
     print('\nStep 2/4: Detecting installed MCP clients...');
     const clients = detectMCPClients();
-    const detectedClients = clients.filter((c) => c.detected);
+    const detectedClients = clients.filter((client) => client.detected);
     if (detectedClients.length === 0) {
         printWarning('No MCP clients detected on this system');
         printInfo('Supported clients: Claude Desktop, Cline, Continue.dev, Zed, Cursor, Windsurf, Roo Code, Claude Code CLI, Amazon Q');
@@ -372,14 +372,14 @@ function main() {
     validateTokens();
     // Final summary
     printHeader('Setup Complete! 🎉');
-    const generatedCount = detectedClients.filter((c) => c.configGenerated).length;
+    const generatedCount = detectedClients.filter((client) => client.configGenerated).length;
     if (generatedCount > 0) {
         printSuccess(`Successfully configured ${generatedCount} MCP client(s)`);
         print('\n📝 Next Steps:', 'cyan');
         print('  1. Restart your MCP clients (Claude Desktop, Cursor, Zed, etc.)');
         print('  2. Verify connection in MCP client settings/logs');
         print('  3. Test with: "List my eBay inventory items"');
-        if (validation.warnings.some((w) => w.includes('EBAY_REDIRECT_URI'))) {
+        if (validation.warnings.some((warning) => warning.includes('EBAY_REDIRECT_URI'))) {
             print('\n💡 Pro Tip:', 'yellow');
             print('  Add EBAY_REDIRECT_URI to .env for user OAuth (10k-50k req/day rate limits)');
         }

package/build/scripts/{buildUi.js → buildMcpApps.js}

@@ -1,44 +1,44 @@
 /**
- * Builds the three interactive MCP Apps views into self-contained HTML files
- * under `build/ui/`.
+ * Builds the interactive MCP Apps views in `mcp-apps/` into self-contained HTML
+ * files under `build/ui/`.
  *
  * Why a script rather than a single `vite.config.ts`: `vite-plugin-singlefile`
  * inlines all dynamic imports, which Rollup only permits with a single input.
- * The three archetypes are therefore built one at a time (each its own
+ * The archetypes are therefore built one at a time (each its own
  * single-page build) into a shared output directory — the first pass clears it,
  * the rest append. The result is exactly what `src/mcp/uiBridge.ts` expects:
- * `build/ui/{table,card,chart}.html`, each with its JS and CSS inlined so the
+ * `build/ui/{table,card,chart,stat}.html`, each with its JS and CSS inlined so the
  * server can serve it verbatim as a `ui://` resource with no sibling requests.
  *
- * Run via `npm run build:ui` (also chained into `npm run build`).
+ * Run via `pnpm build:mcp-apps` (also chained into `pnpm build`).
  */
-import { dirname, resolve } from 'node:path';
+import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { build } from 'vite';
 import { viteSingleFile } from 'vite-plugin-singlefile';
 import { uiArchetypes } from '../tools/ui/archetypes.js';
 import { serverLogger } from '../utils/logger.js';
-const scriptsDir = dirname(fileURLToPath(import.meta.url));
-const repoRoot = resolve(scriptsDir, '../..');
-const uiDir = resolve(repoRoot, 'ui');
-const outDir = resolve(repoRoot, 'build', 'ui');
+const scriptsDir = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(scriptsDir, '../..');
+const mcpAppsDir = path.resolve(repoRoot, 'mcp-apps');
+const outDir = path.resolve(repoRoot, 'build', 'ui');
 /** Vite config for a single archetype's single-page, fully-inlined build. */
 function configFor(archetype, clean) {
     return {
-        root: uiDir,
+        root: mcpAppsDir,
         configFile: false,
         logLevel: 'warn',
         plugins: [viteSingleFile()],
         esbuild: { jsx: 'automatic', jsxImportSource: 'react' },
         resolve: {
             alias: {
-                '@': resolve(repoRoot, 'src'),
+                '@': path.resolve(repoRoot, 'src'),
             },
         },
         build: {
             outDir,
             emptyOutDir: clean,
-            rollupOptions: { input: resolve(uiDir, uiArchetypes[archetype].htmlFile) },
+            rollupOptions: { input: path.resolve(mcpAppsDir, uiArchetypes[archetype].htmlFile) },
         },
     };
 }

package/build/scripts/devSync.js

@@ -9,10 +9,12 @@ import { getErrorMessage } from '../utils/errors.js';
 import { httpRequest } from '../utils/http.js';
 import process from 'node:process';
 import { replaceDanglingSchemaRefs } from './specRefs.js';
+import { specSources } from './specSources.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const PROJECT_ROOT = join(__dirname, '../..');
-const DOCS_DIR = join(PROJECT_ROOT, 'docs');
+/** Local, git-ignored cache of downloaded eBay OpenAPI specs. */
+const SPECS_DIR = join(PROJECT_ROOT, '.cache/ebay-specs');
 const TYPES_DIR = join(PROJECT_ROOT, 'src/types');
 const TOOLS_DIRS = [join(PROJECT_ROOT, 'src/tools/categories')];
 /** Repo-specific OpenAPI namespace aliases preserved after type regeneration. */
@@ -101,85 +103,34 @@ function showSpinner(message) {
         process.stdout.write('\r' + ' '.repeat(message.length + 10) + '\r');
     };
 }
-const SPEC_FOLDER_MAP = {
-    'developer_analytics_v1_beta_oas3.json': 'application-settings',
-    'developer_key_management_v1_oas3.json': 'application-settings',
-    'developer_client_registration_v1_oas3.json': 'application-settings',
-    'sell_inventory_v1_oas3.json': 'sell-apps/listing-management',
-    'sell_feed_v1_oas3.json': 'sell-apps/listing-management',
-    'commerce_media_v1_beta_oas3.json': 'sell-apps/listing-management',
-    'sell_stores_v1_oas3.json': 'sell-apps/listing-management',
-    'sell_metadata_v1_oas3.json': 'sell-apps/listing-metadata',
-    'commerce_taxonomy_v1_oas3.json': 'sell-apps/listing-metadata',
-    'commerce_charity_v1_oas3.json': 'sell-apps/listing-metadata',
-    'sell_account_v1_oas3.json': 'sell-apps/account-management',
-    'sell_account_v2_oas3.json': 'sell-apps/account-management',
-    'sell_finances_v1_oas3.json': 'sell-apps/account-management',
-    'commerce_message_v1_oas3.json': 'sell-apps/communication',
-    'commerce_notification_v1_oas3.json': 'sell-apps/communication',
-    'sell_negotiation_v1_oas3.json': 'sell-apps/communication',
-    'commerce_feedback_v1_beta_oas3.json': 'sell-apps/communication',
-    'sell_fulfillment_v1_oas3.json': 'sell-apps/order-management',
-    'sell_logistics_v1_oas3.json': 'sell-apps/order-management',
-    'sell_marketing_v1_oas3.json': 'sell-apps/marketing-and-promotions',
-    'sell_recommendation_v1_oas3.json': 'sell-apps/marketing-and-promotions',
-    'sell_analytics_v1_oas3.json': 'sell-apps/analytics-and-report',
-    'commerce_translation_v1_beta_oas3.json': 'sell-apps/other-apis',
-    'sell_compliance_v1_oas3.json': 'sell-apps/other-apis',
-    'commerce_identity_v1_oas3.json': 'sell-apps/other-apis',
-    'sell_edelivery_international_shipping_oas3.json': 'sell-apps/other-apis',
-    'commerce_vero_v1_oas3.json': 'sell-apps/other-apis',
-    'buy_browse_v1_oas3.json': 'buy-apps/inventory-discovery',
-    'buy_feed_v1_beta_oas3.json': 'buy-apps/inventory-discovery',
-    'buy_feed_v1_oas3.json': 'buy-apps/inventory-discovery',
-    'buy_deal_v1_oas3.json': 'buy-apps/marketing-and-discounts',
-    'buy_marketing_v1_beta_oas3.json': 'buy-apps/marketing-and-discounts',
-    'commerce_catalog_v1_beta_oas3.json': 'buy-apps/marketplace-metadata',
-    'buy_order_v2_oas3.json': 'buy-apps/checkout-and-bidding',
-    'buy_offer_v1_beta_oas3.json': 'buy-apps/checkout-and-bidding',
-};
 async function downloadSpecs() {
     console.log(ui.bold('\n📥 Downloading OpenAPI Specifications\n'));
-    const readmePath = join(DOCS_DIR, 'sell-apps/README.md');
-    if (!existsSync(readmePath)) {
-        console.log(ui.warning(`  ⚠ README not found at ${readmePath}`));
-        console.log(ui.dim('    Create docs/sell-apps/README.md with spec URLs'));
-        return 0;
-    }
-    const readmeContent = readFileSync(readmePath, 'utf-8');
-    const urlRegex = /(https:\/\/[^\s)]+\.json)/g;
-    const urls = Array.from(readmeContent.matchAll(urlRegex)).map((m) => m[1]);
-    if (urls.length === 0) {
-        console.log(ui.warning('  ⚠ No spec URLs found in README'));
-        return 0;
-    }
-    console.log(ui.dim(`  Found ${urls.length} spec URLs\n`));
+    console.log(ui.dim(`  Found ${specSources.length} spec URLs\n`));
     let downloaded = 0;
     let failed = 0;
-    for (const url of urls) {
+    for (const { api, folder, url } of specSources) {
         const fileName = basename(url);
-        const folderName = SPEC_FOLDER_MAP[fileName] || 'other-apis';
-        const folderPath = join(DOCS_DIR, folderName);
+        const folderPath = join(SPECS_DIR, folder);
         const filePath = join(folderPath, fileName);
-        const stopSpinner = showSpinner(`Downloading ${fileName}...`);
+        const stopSpinner = showSpinner(`Downloading ${api} (${fileName})...`);
         const downloadedSpec = await Effect.runPromise(Effect.either(Effect.tryPromise({
             try: async () => {
                 mkdirSync(folderPath, { recursive: true });
-                const response = await httpRequest({
+                const specResponse = await httpRequest({
                     url,
                     responseType: 'arraybuffer',
                     timeoutMs: 20_000,
                 });
-                writeFileSync(filePath, response.data);
+                writeFileSync(filePath, specResponse.data);
             },
             catch: (error) => error,
         }).pipe(Effect.ensuring(Effect.sync(stopSpinner)))));
         if (Either.isLeft(downloadedSpec)) {
-            console.log(`  ${ui.error('✗')} ${fileName}: ${getErrorMessage(downloadedSpec.left)}`);
+            console.log(`  ${ui.error('✗')} ${api} (${fileName}): ${getErrorMessage(downloadedSpec.left)}`);
             failed++;
         }
         else {
-            console.log(`  ${ui.success('✓')} ${fileName}`);
+            console.log(`  ${ui.success('✓')} ${api} (${fileName})`);
             downloaded++;
         }
     }
@@ -215,7 +166,7 @@ function generateTypes() {
                     skipped++;
                     continue;
                 }
-                const relativePath = fullPath.replace(DOCS_DIR + '/', '');
+                const relativePath = fullPath.replace(SPECS_DIR + '/', '');
                 const outputDir = join(TYPES_DIR, dirname(relativePath));
                 mkdirSync(outputDir, { recursive: true });
                 const baseFileName = basename(entry.name, '.json');
@@ -258,7 +209,7 @@ function generateTypes() {
             }
         }
     }
-    processDirectory(DOCS_DIR);
+    processDirectory(SPECS_DIR);
     console.log(ui.dim(`\n  Generated: ${generated}, Skipped: ${skipped}`));
     return generated;
 }
@@ -299,7 +250,7 @@ function extractEndpointsFromSpecs() {
             }
         }
     }
-    processDirectory(DOCS_DIR);
+    processDirectory(SPECS_DIR);
     return endpoints;
 }
 function collectToolNames(dir, tools) {
@@ -481,7 +432,7 @@ function analyzeEndpoints() {
     const implementedTools = getImplementedTools();
     const implementedApiMethods = getImplementedApiMethods();
     // Normalize all tool names
-    const normalizedTools = new Set(Array.from(implementedTools).map((t) => normalizeForMatching(t)));
+    const normalizedTools = new Set(Array.from(implementedTools).map((toolName) => normalizeForMatching(toolName)));
     // Combine tools and API methods for matching
     const allImplemented = new Set([...normalizedTools, ...implementedApiMethods]);
     // Track unique endpoints (dedupe by operationId)
@@ -596,7 +547,7 @@ ${ui.bold('What this does:')}
     if (!(reportOnly || skipDownload)) {
         report.specsDownloaded = await downloadSpecs();
     }
-    // If the download step ran but fetched nothing (missing manifest or blocked
+    // If the download step ran but fetched nothing (for example, blocked
     // requests), the coverage numbers below describe the cached specs on disk —
     // not eBay's current API. Flag it loudly so a stale run is never mistaken for
     // a clean "100% coverage, 0 missing" result.
@@ -623,9 +574,9 @@ ${ui.bold('What this does:')}
 void Effect.runPromise(Effect.either(Effect.tryPromise({
     try: () => main(),
     catch: (error) => error,
-}))).then((result) => {
-    if (Either.isLeft(result)) {
-        console.error(ui.error('\n  Sync failed:'), getErrorMessage(result.left));
+}))).then((syncOutcome) => {
+    if (Either.isLeft(syncOutcome)) {
+        console.error(ui.error('\n  Sync failed:'), getErrorMessage(syncOutcome.left));
         process.exitCode = 1;
     }
 });