{"openapi":"3.1.0","info":{"title":"Mailchimp Assets (BYOK) API","version":"0.1.0","description":"Mailchimp Assets (BYOK) lets an AI assistant read your own Mailchimp Assets data through the Mailchimp Assets API with a key you supply (API key (its suffix after the hyphen is your server prefix)). Read-only: 10 tools (ping_api, list_templates, list_template_folders, list_campaign_folders, list_landing_pages, list_landing_page_reports, list_file_folders, list_sending_domains,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-mailchimp-assets.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-mailchimp-assets/docs"},"termsOfService":"https://connectorbay.com/byok-mailchimp-assets/terms"},"servers":[{"url":"https://byok-mailchimp-assets.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-mailchimp-assets/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/ping_api":{"post":{"operationId":"ping_api","summary":"Check that the key works and the Mailchimp API is reachable; returns a health status text. Use for \"Is my Mailchimp API ","description":"Check that the key works and the Mailchimp API is reachable; returns a health status text. Use for \"Is my Mailchimp API key working\".","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"}},"required":["dc"],"title":"ping_apiArguments","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_templates":{"post":{"operationId":"list_templates","summary":"List email templates: id, name, type (user, base or gallery), category, drag-and-drop flag, folder, creator and dates. T","description":"List email templates: id, name, type (user, base or gallery), category, drag-and-drop flag, folder, creator and dates. Template HTML is not returned. Use for \"Which email templates do I have in Mailchimp\".","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"},"type":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only templates of this type, for example 'user', 'base' or 'gallery'.","title":"Type"},"folder_id":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only templates in this template folder id.","title":"Folder Id"},"sort_field":{"anyOf":[{"enum":["date_created","date_edited","name"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by date_created, date_edited or name.","title":"Sort Field"},"sort_dir":{"anyOf":[{"enum":["ASC","DESC"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: ASC or DESC.","title":"Sort Dir"}},"required":["dc"],"title":"list_templatesArguments","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_template_folders":{"post":{"operationId":"list_template_folders","summary":"List the folders that organize email templates, with how many templates each holds. Use for \"Which template folders exis","description":"List the folders that organize email templates, with how many templates each holds. Use for \"Which template folders exist in 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_template_foldersArguments","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_campaign_folders":{"post":{"operationId":"list_campaign_folders","summary":"List the folders that organize campaigns, with how many campaigns each holds. Use for \"Which campaign folders do I have ","description":"List the folders that organize campaigns, with how many campaigns each holds. Use for \"Which campaign folders do I have in Mailchimp\".","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_campaign_foldersArguments","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_landing_pages":{"post":{"operationId":"list_landing_pages","summary":"List landing pages with name, title, status (published, unpublished, draft), audience id, URL and dates. Use for \"Which ","description":"List landing pages with name, title, status (published, unpublished, draft), audience id, URL and dates. Use for \"Which landing pages are published in Mailchimp\".","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"},"sort_field":{"anyOf":[{"enum":["created_at","updated_at"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by created_at or updated_at.","title":"Sort Field"},"sort_dir":{"anyOf":[{"enum":["ASC","DESC"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction: ASC or DESC.","title":"Sort Dir"}},"required":["dc"],"title":"list_landing_pagesArguments","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_landing_page_reports":{"post":{"operationId":"list_landing_page_reports","summary":"List landing page performance: visits, unique visits, subscribes, clicks and conversion rate per page. Use for \"How are ","description":"List landing page performance: visits, unique visits, subscribes, clicks and conversion rate per page. Use for \"How are my Mailchimp landing pages converting\".","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_landing_page_reportsArguments","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_file_folders":{"post":{"operationId":"list_file_folders","summary":"List File Manager folders (image and document libraries) with file counts and creation dates. File names and contents ar","description":"List File Manager folders (image and document libraries) with file counts and creation dates. File names and contents are not returned. Use for \"Which File Manager folders do I have in Mailchimp\".","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_file_foldersArguments","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_sending_domains":{"post":{"operationId":"list_sending_domains","summary":"List sending domains with verification and authentication status (for example VERIFIED or AUTHENTICATION_ERROR). Use for","description":"List sending domains with verification and authentication status (for example VERIFIED or AUTHENTICATION_ERROR). Use for \"Are my Mailchimp sending domains verified and authenticated\".","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"}},"required":["dc"],"title":"list_sending_domainsArguments","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_connected_sites":{"post":{"operationId":"list_connected_sites","summary":"List connected websites with platform, domain, pixel status and dates. Use for \"Which websites are connected to my Mailc","description":"List connected websites with platform, domain, pixel status and dates. Use for \"Which websites 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_connected_sitesArguments","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_batch_jobs":{"post":{"operationId":"list_batch_jobs","summary":"List recent batch operation jobs with status, operation totals, errored count and submission and completion times. Use f","description":"List recent batch operation jobs with status, operation totals, errored count and submission and completion times. Use for \"Did my last Mailchimp batch jobs finish without errors\".","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_batch_jobsArguments","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}}}}