{"openapi":"3.1.0","info":{"title":"Maxio Advanced Billing (BYOK) API","version":"0.1.0","description":"Maxio Advanced Billing (BYOK) lets an AI assistant read your own Maxio Advanced Billing data through the Maxio Advanced Billing API with a key you supply (Maxio Advanced Billing API key). Read-only: 6 tools (list_product_price_points, list_component_price_points, list_offers, get_offer, list_metafields, list_webhook_endpoints). The BYOK key travels with each request, is used for that one call...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-maxio-config.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-maxio-config/docs"},"termsOfService":"https://connectorbay.com/byok-maxio-config/terms"},"servers":[{"url":"https://byok-maxio-config.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-maxio-config/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_product_price_points":{"post":{"operationId":"list_product_price_points","summary":"List the price points of every product on the site with price, billing interval, trial settings, initial charge and type","description":"List the price points of every product on the site with price, billing interval, trial settings, initial charge and type (catalog, default or custom). Use for \"What price points do my Maxio products have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"subdomain":{"description":"Your Maxio Advanced Billing (Chargify) site subdomain, the first part of <subdomain>.chargify.com.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Subdomain","type":"string"},"direction":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort order: asc or desc.","title":"Direction"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Records per page (1 to 200, default 20).","title":"Per Page"}},"required":["subdomain"],"title":"list_product_price_pointsArguments","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_component_price_points":{"post":{"operationId":"list_component_price_points","summary":"List the price points of every component (metered, quantity, on/off, prepaid) with pricing scheme, billing interval and ","description":"List the price points of every component (metered, quantity, on/off, prepaid) with pricing scheme, billing interval and type. Use for \"What price points do my Maxio components have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"subdomain":{"description":"Your Maxio Advanced Billing (Chargify) site subdomain, the first part of <subdomain>.chargify.com.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Subdomain","type":"string"},"direction":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort order: asc or desc.","title":"Direction"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Records per page (1 to 200, default 20).","title":"Per Page"}},"required":["subdomain"],"title":"list_component_price_pointsArguments","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_offers":{"post":{"operationId":"list_offers","summary":"List offers (a product plus components and discounts packaged for sale) with product, price point and creation time. Arc","description":"List offers (a product plus components and discounts packaged for sale) with product, price point and creation time. Archived offers only when requested. Use for \"Which offers have I set up in Maxio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"subdomain":{"description":"Your Maxio Advanced Billing (Chargify) site subdomain, the first part of <subdomain>.chargify.com.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Subdomain","type":"string"},"include_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include archived offers.","title":"Include Archived"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Records per page (1 to 200, default 20).","title":"Per Page"}},"required":["subdomain"],"title":"list_offersArguments","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_offer":{"post":{"operationId":"get_offer","summary":"Get one offer by id: product, price point, price, handle and creation time. Use for \"Show Maxio offer 239\".","description":"Get one offer by id: product, price point, price, handle and creation time. Use for \"Show Maxio offer 239\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"subdomain":{"description":"Your Maxio Advanced Billing (Chargify) site subdomain, the first part of <subdomain>.chargify.com.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Subdomain","type":"string"},"offer_id":{"description":"Offer id (a number).","title":"Offer Id","type":"integer"}},"required":["subdomain","offer_id"],"title":"get_offerArguments","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_metafields":{"post":{"operationId":"list_metafields","summary":"List custom field definitions (name, input type, where the field is shown, how many records use it) for subscriptions or","description":"List custom field definitions (name, input type, where the field is shown, how many records use it) for subscriptions or customers. Use for \"Which custom fields are defined on Maxio subscriptions\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"subdomain":{"description":"Your Maxio Advanced Billing (Chargify) site subdomain, the first part of <subdomain>.chargify.com.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Subdomain","type":"string"},"resource_type":{"description":"Which kind of record the custom fields belong to: subscriptions or customers.","maxLength":200,"title":"Resource Type","type":"string"},"name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only the custom field with this name.","title":"Name"},"direction":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort order: asc or desc.","title":"Direction"}},"required":["subdomain","resource_type"],"title":"list_metafieldsArguments","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_webhook_endpoints":{"post":{"operationId":"list_webhook_endpoints","summary":"List the webhook endpoints configured on the site with URL, status and the events each one subscribes to. Use for \"Where","description":"List the webhook endpoints configured on the site with URL, status and the events each one subscribes to. Use for \"Where does my Maxio site send webhooks\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"subdomain":{"description":"Your Maxio Advanced Billing (Chargify) site subdomain, the first part of <subdomain>.chargify.com.","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Subdomain","type":"string"}},"required":["subdomain"],"title":"list_webhook_endpointsArguments","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}}}}