{"openapi":"3.1.0","info":{"title":"Wix Shipping, Tax and Locations Setup (your key) API","version":"0.1.0","description":"Wix Shipping, Tax and Locations Setup (your key) lets an AI assistant read your own Wix Ecom Setup data through the Wix Ecom Setup API with a key you supply (Wix API key). Read-only: 7 tools (query_delivery_profiles, get_delivery_profile, list_installed_delivery_carriers, query_tax_groups, list_default_tax_groups, query_tax_regions, list_locations). The BYOK key travels with each request, is used...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-wix-ecom-setup.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-wix-ecom-setup/docs"},"termsOfService":"https://connectorbay.com/byok-wix-ecom-setup/terms"},"servers":[{"url":"https://byok-wix-ecom-setup.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-wix-ecom-setup/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/query_delivery_profiles":{"post":{"operationId":"query_delivery_profiles","summary":"List the site's delivery profiles (up to 100) with their delivery regions, assigned carriers, backup rates and destinati","description":"List the site's delivery profiles (up to 100) with their delivery regions, assigned carriers, backup rates and destination countries, newest first. Use for \"Which shipping regions and carriers are set up on my Wix site\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 100).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's next-page value; leave out for the first page.","title":"Cursor"}},"title":"query_delivery_profilesArguments","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_delivery_profile":{"post":{"operationId":"get_delivery_profile","summary":"Get one delivery profile by id with its regions, carriers, backup rates and destinations. Use for \"Show Wix delivery pro","description":"Get one delivery profile by id with its regions, carriers, backup rates and destinations. Use for \"Show Wix delivery profile 8046df3c-7575-4098-a5ab-c91ad8f33c47\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"delivery_profile_id":{"description":"Delivery profile id (a GUID from query_delivery_profiles).","maxLength":64,"title":"Delivery Profile Id","type":"string"}},"required":["delivery_profile_id"],"title":"get_delivery_profileArguments","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_installed_delivery_carriers":{"post":{"operationId":"list_installed_delivery_carriers","summary":"List the delivery carrier apps installed on the site with display name, description and whether they support settings an","description":"List the delivery carrier apps installed on the site with display name, description and whether they support settings and activation changes. Use for \"Which delivery carrier apps are installed on my Wix site\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_installed_delivery_carriersArguments","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/query_tax_groups":{"post":{"operationId":"query_tax_groups","summary":"List the tax groups created on the site (names and ids used to classify products) with revision and dates. Use for \"Whic","description":"List the tax groups created on the site (names and ids used to classify products) with revision and dates. Use for \"Which tax groups does my Wix site have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 100).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's next-page value; leave out for the first page.","title":"Cursor"}},"title":"query_tax_groupsArguments","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_default_tax_groups":{"post":{"operationId":"list_default_tax_groups","summary":"List the default tax groups Wix provides (such as general goods) with id and name. Use for \"What default tax groups does","description":"List the default tax groups Wix provides (such as general goods) with id and name. Use for \"What default tax groups does Wix offer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_default_tax_groupsArguments","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/query_tax_regions":{"post":{"operationId":"query_tax_regions","summary":"List the tax regions (country and subdivision) with the tax calculator app and whether tax is included in prices. Use fo","description":"List the tax regions (country and subdivision) with the tax calculator app and whether tax is included in prices. Use for \"Which tax regions are configured on my Wix site\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Only regions of this country (two-letter code such as US); leave out for all.","title":"Country"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 100).","title":"Limit"},"cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's next-page value; leave out for the first page.","title":"Cursor"}},"title":"query_tax_regionsArguments","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_locations":{"post":{"operationId":"list_locations","summary":"List the site's business locations with name, default flag, status, time zone and city/country (street, phone and email ","description":"List the site's business locations with name, default flag, status, time zone and city/country (street, phone and email are left out). Use for \"Which business locations does my Wix site have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"include_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to include archived locations.","title":"Include Archived"}},"title":"list_locationsArguments","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}}}}