{"openapi":"3.1.0","info":{"title":"Mailchimp Ecommerce (BYOK) API","version":"0.1.0","description":"Mailchimp Ecommerce (BYOK) lets an AI assistant read your own Mailchimp Ecommerce data through the Mailchimp Ecommerce API with a key you supply (API key (its suffix after the hyphen is your server prefix)). Read-only: 7 tools (list_stores, get_store, list_products, get_product, list_product_variants, list_promo_rules, get_promo_rule). The BYOK key travels with each request, is used for that one...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-mailchimp-ecommerce.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-mailchimp-ecommerce/docs"},"termsOfService":"https://connectorbay.com/byok-mailchimp-ecommerce/terms"},"servers":[{"url":"https://byok-mailchimp-ecommerce.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-mailchimp-ecommerce/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_stores":{"post":{"operationId":"list_stores","summary":"List connected e-commerce stores with platform, domain, linked audience id, sync state, currency, locale and timezone. S","description":"List connected e-commerce stores with platform, domain, linked audience id, sync state, currency, locale and timezone. Store address, phone and email are not returned. Use for \"Which online stores are connected to my Mailchimp account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dc":{"description":"Your Mailchimp server prefix (data center): the suffix after the hyphen in your API key, for example 'us6' for a key ending in -us6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Dc","type":"string"},"count":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 1000; the connector shows at most 50 per answer).","title":"Count"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging. Use the previous offset plus count for the next page.","title":"Offset"}},"required":["dc"],"title":"list_storesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_store":{"post":{"operationId":"get_store","summary":"Get one connected store: platform, domain, audience link, sync state, currency and the status of its abandoned cart and ","description":"Get one connected store: platform, domain, audience link, sync state, currency and the status of its abandoned cart and abandoned browse automations. Use for \"Is my Mailchimp store store_1 syncing and are its abandoned cart emails running\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dc":{"description":"Your Mailchimp server prefix (data center): the suffix after the hyphen in your API key, for example 'us6' for a key ending in -us6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Dc","type":"string"},"store_id":{"description":"The e-commerce store id, from list_stores, for example 'store_1'.","maxLength":60,"title":"Store Id","type":"string"}},"required":["dc","store_id"],"title":"get_storeArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_products":{"post":{"operationId":"list_products","summary":"List a store's product catalog: id, title, handle, URL, type, vendor and currency. Variants and descriptions are not inc","description":"List a store's product catalog: id, title, handle, URL, type, vendor and currency. Variants and descriptions are not included here. Use for \"What products does my Mailchimp store store_1 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dc":{"description":"Your Mailchimp server prefix (data center): the suffix after the hyphen in your API key, for example 'us6' for a key ending in -us6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Dc","type":"string"},"store_id":{"description":"The e-commerce store id, from list_stores, for example 'store_1'.","maxLength":60,"title":"Store Id","type":"string"},"count":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 1000; the connector shows at most 50 per answer).","title":"Count"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging. Use the previous offset plus count for the next page.","title":"Offset"}},"required":["dc","store_id"],"title":"list_productsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_product":{"post":{"operationId":"get_product","summary":"Get one product of a store with title, URL, type, vendor and currency. Use for \"Show Mailchimp product prod_1 of store s","description":"Get one product of a store with title, URL, type, vendor and currency. Use for \"Show Mailchimp product prod_1 of store store_1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dc":{"description":"Your Mailchimp server prefix (data center): the suffix after the hyphen in your API key, for example 'us6' for a key ending in -us6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Dc","type":"string"},"store_id":{"description":"The e-commerce store id, from list_stores, for example 'store_1'.","maxLength":60,"title":"Store Id","type":"string"},"product_id":{"description":"The product id inside the store, from list_products.","maxLength":80,"title":"Product Id","type":"string"}},"required":["dc","store_id","product_id"],"title":"get_productArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_product_variants":{"post":{"operationId":"list_product_variants","summary":"List the variants of a product with SKU, price, inventory quantity, visibility and backorder setting. Use for \"What size","description":"List the variants of a product with SKU, price, inventory quantity, visibility and backorder setting. Use for \"What sizes and stock levels does Mailchimp product prod_1 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dc":{"description":"Your Mailchimp server prefix (data center): the suffix after the hyphen in your API key, for example 'us6' for a key ending in -us6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Dc","type":"string"},"store_id":{"description":"The e-commerce store id, from list_stores, for example 'store_1'.","maxLength":60,"title":"Store Id","type":"string"},"product_id":{"description":"The product id inside the store, from list_products.","maxLength":80,"title":"Product Id","type":"string"},"count":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 1000; the connector shows at most 50 per answer).","title":"Count"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging. Use the previous offset plus count for the next page.","title":"Offset"}},"required":["dc","store_id","product_id"],"title":"list_product_variantsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_promo_rules":{"post":{"operationId":"list_promo_rules","summary":"List a store's promotion rules: title, validity window, amount, type (fixed or percentage), target and enabled flag. Pro","description":"List a store's promotion rules: title, validity window, amount, type (fixed or percentage), target and enabled flag. Promo codes are not returned. Use for \"Which discount rules are active in my Mailchimp store store_1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dc":{"description":"Your Mailchimp server prefix (data center): the suffix after the hyphen in your API key, for example 'us6' for a key ending in -us6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Dc","type":"string"},"store_id":{"description":"The e-commerce store id, from list_stores, for example 'store_1'.","maxLength":60,"title":"Store Id","type":"string"},"count":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 1000; the connector shows at most 50 per answer).","title":"Count"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging. Use the previous offset plus count for the next page.","title":"Offset"}},"required":["dc","store_id"],"title":"list_promo_rulesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_promo_rule":{"post":{"operationId":"get_promo_rule","summary":"Get one promotion rule of a store. Use for \"Show Mailchimp promo rule rule_1 of store store_1\".","description":"Get one promotion rule of a store. Use for \"Show Mailchimp promo rule rule_1 of store store_1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dc":{"description":"Your Mailchimp server prefix (data center): the suffix after the hyphen in your API key, for example 'us6' for a key ending in -us6.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Dc","type":"string"},"store_id":{"description":"The e-commerce store id, from list_stores, for example 'store_1'.","maxLength":60,"title":"Store Id","type":"string"},"promo_rule_id":{"description":"The promo rule id, from list_promo_rules.","maxLength":80,"title":"Promo Rule Id","type":"string"}},"required":["dc","store_id","promo_rule_id"],"title":"get_promo_ruleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}