{"openapi":"3.1.0","info":{"title":"Asaas (BYOK) API","version":"0.1.0","description":"Asaas (BYOK) lets an AI assistant read your own Asaas data through the Asaas API with a key you supply (Asaas production API key). Read-only: 7 tools (get_account_fees, list_webhooks, get_anticipation_limits, get_automatic_anticipation_status, list_municipal_services, get_escrow_config, get_preauthorization_config). The BYOK key travels with each request, is used for that one call only and is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-asaas-config.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-asaas-config/docs"},"termsOfService":"https://connectorbay.com/byok-asaas-config/terms"},"servers":[{"url":"https://byok-asaas-config.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-asaas-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/get_account_fees":{"post":{"operationId":"get_account_fees","summary":"Show the fee schedule and settlement times of the account: boleto, credit card (per installment band), debit card and Pi","description":"Show the fee schedule and settlement times of the account: boleto, credit card (per installment band), debit card and Pix fees, transfer, notification, dunning and anticipation fees, with any discounts and their expiry. Amounts are in reais or percent. Use for \"What fees does my Asaas account pay for Pix, boleto and credit card\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_account_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 subscriptions with name, URL, enabled and interrupted flags, API version, whether an auth token is set, sen","description":"List webhook subscriptions with name, URL, enabled and interrupted flags, API version, whether an auth token is set, send order and subscribed events. The notification email and the token are not returned. Use for \"Where does my Asaas account send webhooks and are any interrupted\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging (default 0).","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many records to return (1 to 100, default 10).","title":"Limit"}},"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/get_anticipation_limits":{"post":{"operationId":"get_anticipation_limits","summary":"Show the total and currently available receivables anticipation limits for credit card and boleto payments, in reais. Us","description":"Show the total and currently available receivables anticipation limits for credit card and boleto payments, in reais. Use for \"How much anticipation limit do I have left in Asaas\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_anticipation_limitsArguments","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_automatic_anticipation_status":{"post":{"operationId":"get_automatic_anticipation_status","summary":"Show whether automatic anticipation of credit card receivables is switched on. Use for \"Is automatic anticipation enable","description":"Show whether automatic anticipation of credit card receivables is switched on. Use for \"Is automatic anticipation enabled on my Asaas account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_automatic_anticipation_statusArguments","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_municipal_services":{"post":{"operationId":"list_municipal_services","summary":"List the municipal services available for invoice (nota fiscal) issuing with id, description and ISS tax rate. Optional ","description":"List the municipal services available for invoice (nota fiscal) issuing with id, description and ISS tax rate. Optional text filter on the description. Use for \"Which municipal service codes can I use for invoices in Asaas\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"description":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only services whose description contains this text.","title":"Description"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many records to skip, for paging (default 0).","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many records to return (1 to 100, default 10).","title":"Limit"}},"title":"list_municipal_servicesArguments","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_escrow_config":{"post":{"operationId":"get_escrow_config","summary":"Show the default escrow account setting: whether it is enabled, days until it expires and whether the account pays the f","description":"Show the default escrow account setting: whether it is enabled, days until it expires and whether the account pays the fee. Use for \"What is my default Asaas escrow configuration\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_escrow_configArguments","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_preauthorization_config":{"post":{"operationId":"get_preauthorization_config","summary":"Show how many days a credit card pre-authorization stays valid before it expires. Use for \"How long do Asaas card pre-au","description":"Show how many days a credit card pre-authorization stays valid before it expires. Use for \"How long do Asaas card pre-authorizations last\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_preauthorization_configArguments","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}}}}