{"openapi":"3.1.0","info":{"title":"Rebilly (BYOK) API","version":"0.1.0","description":"Rebilly (BYOK) lets an AI assistant read your own Rebilly data through the Rebilly API with a key you supply (Rebilly secret API key). Read-only: 9 tools (list_shipping_rates, list_payment_method_catalog, list_payment_gateway_catalog, list_fees, list_webhooks, list_websites, list_gateway_accounts, list_journal_accounts, get_risk_score_rules). The BYOK key travels with each request, is used for...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-rebilly-config.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-rebilly-config/docs"},"termsOfService":"https://connectorbay.com/byok-rebilly-config/terms"},"servers":[{"url":"https://byok-rebilly-config.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-rebilly-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_shipping_rates":{"post":{"operationId":"list_shipping_rates","summary":"List shipping rates with name, price, currency, the filter rule that selects them and active status. Use for \"What shipp","description":"List shipping rates with name, price, currency, the filter rule that selects them and active status. Use for \"What shipping rates are configured in Rebilly\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (1 to 1000; provider default 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging (0 to 1000).","title":"Offset"},"filter":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Rebilly filter expression, for example 'status:active'. Fields depend on the resource.","title":"Filter"},"q":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over the record's text fields.","title":"Q"}},"title":"list_shipping_ratesArguments","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_payment_method_catalog":{"post":{"operationId":"list_payment_method_catalog","summary":"List the payment methods Rebilly supports (cards, wallets, bank transfers and others) with supported countries and curre","description":"List the payment methods Rebilly supports (cards, wallets, bank transfers and others) with supported countries and currencies, recurring, refund and dispute support. Use for \"Which payment methods can Rebilly process and do they support recurring payments\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (1 to 1000; provider default 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging (0 to 1000).","title":"Offset"}},"title":"list_payment_method_catalogArguments","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_payment_gateway_catalog":{"post":{"operationId":"list_payment_gateway_catalog","summary":"List the payment gateways Rebilly integrates with: supported payment methods, card brands, currencies, merchant countrie","description":"List the payment gateways Rebilly integrates with: supported payment methods, card brands, currencies, merchant countries, reconciliation and dispute support. No credentials. Use for \"Which payment gateways does Rebilly integrate with and what do they support\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_payment_gateway_catalogArguments","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_fees":{"post":{"operationId":"list_fees","summary":"List fee entries that model gateway or settlement costs: buy or sell side, filter rule, fixed amount or basis points and","description":"List fee entries that model gateway or settlement costs: buy or sell side, filter rule, fixed amount or basis points and settlement currency. Use for \"What gateway fees are configured in Rebilly\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (1 to 1000; provider default 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging (0 to 1000).","title":"Offset"},"filter":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Rebilly filter expression, for example 'status:active'. Fields depend on the resource.","title":"Filter"}},"title":"list_feesArguments","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_webhooks":{"post":{"operationId":"list_webhooks","summary":"List webhook endpoints with event filter, status, HTTP method and URL. Custom headers, body templates and credentials ar","description":"List webhook endpoints with event filter, status, HTTP method and URL. Custom headers, body templates and credentials are not returned. Use for \"Where does my Rebilly account send webhooks\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (1 to 1000; provider default 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging (0 to 1000).","title":"Offset"},"filter":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Rebilly filter expression, for example 'status:active'. Fields depend on the resource.","title":"Filter"}},"title":"list_webhooksArguments","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_websites":{"post":{"operationId":"list_websites","summary":"List websites (storefronts) of the organization with name, URL and creation time. Contact details are not returned. Use ","description":"List websites (storefronts) of the organization with name, URL and creation time. Contact details are not returned. Use for \"Which websites are set up in Rebilly\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (1 to 1000; provider default 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging (0 to 1000).","title":"Offset"},"filter":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Rebilly filter expression, for example 'status:active'. Fields depend on the resource.","title":"Filter"},"q":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over the record's text fields.","title":"Q"}},"title":"list_websitesArguments","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_gateway_accounts":{"post":{"operationId":"list_gateway_accounts","summary":"List gateway accounts (your merchant accounts at payment gateways) with gateway, method, accepted currencies, card schem","description":"List gateway accounts (your merchant accounts at payment gateways) with gateway, method, accepted currencies, card schemes, status, 3-D Secure flag and monthly limit. Credentials are not returned. Use for \"Which payment gateway accounts are active in Rebilly\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (1 to 1000; provider default 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging (0 to 1000).","title":"Offset"},"filter":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Rebilly filter expression, for example 'status:active'. Fields depend on the resource.","title":"Filter"},"q":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over the record's text fields.","title":"Q"}},"title":"list_gateway_accountsArguments","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_journal_accounts":{"post":{"operationId":"list_journal_accounts","summary":"List the revenue accounting journal accounts (for example unearned revenue) with name and description. Use for \"Which jo","description":"List the revenue accounting journal accounts (for example unearned revenue) with name and description. Use for \"Which journal accounts does Rebilly use for revenue accounting\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many records to return (1 to 1000; provider default 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging (0 to 1000).","title":"Offset"},"filter":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Rebilly filter expression, for example 'status:active'. Fields depend on the resource.","title":"Filter"}},"title":"list_journal_accountsArguments","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_risk_score_rules":{"post":{"operationId":"get_risk_score_rules","summary":"Show the risk scoring rules: points added for proxy, VPN, Tor or hosting traffic, mismatched countries and velocity brac","description":"Show the risk scoring rules: points added for proxy, VPN, Tor or hosting traffic, mismatched countries and velocity brackets. Use for \"How are fraud risk scores weighted in my Rebilly account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_risk_score_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}}}}