{"openapi":"3.1.0","info":{"title":"Rende API","version":"0.1.0","description":"Brazilian personal finance and economic indicators: live Selic, CDI, IPCA, USD/BRL and poupança rates from the Central Bank of Brazil, plus CLT salary, CDB, Tesouro Selic, FGTS and investment-comparison calculators.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://rende.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/rende/docs"},"termsOfService":"https://connectorbay.com/rende/terms"},"servers":[{"url":"https://rende.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/rende/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/selic_rate":{"post":{"operationId":"selic_rate","summary":"The current Selic target rate (meta Selic) set by the Copom, from the Central Bank's public series. Use for","description":"The current Selic target rate (meta Selic) set by the Copom, from the Central Bank's public series. Use for\n    \"what's the Selic rate\", \"is the Selic going up\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"selic_rateArguments","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/cdi_rate":{"post":{"operationId":"cdi_rate","summary":"The current CDI daily rate and its compounded annualized equivalent (252 business days), from the Central","description":"The current CDI daily rate and its compounded annualized equivalent (252 business days), from the Central\n    Bank's public series. Use for \"what's the CDI right now\", to price a \"% of CDI\" investment.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"cdi_rateArguments","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/ipca_inflation":{"post":{"operationId":"ipca_inflation","summary":"The latest monthly IPCA change and the 12-month accumulated inflation rate, from the Central Bank's public","description":"The latest monthly IPCA change and the 12-month accumulated inflation rate, from the Central Bank's public\n    series. Use for \"what's inflation in Brazil\", \"12-month IPCA\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"ipca_inflationArguments","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/usd_brl_rate":{"post":{"operationId":"usd_brl_rate","summary":"The latest USD/BRL commercial exchange rate (sell), from the Central Bank's public series. Use for \"dollar to","description":"The latest USD/BRL commercial exchange rate (sell), from the Central Bank's public series. Use for \"dollar to\n    real today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"usd_brl_rateArguments","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/poupanca_yield":{"post":{"operationId":"poupanca_yield","summary":"The current poupança (savings account) monthly yield and its compounded annualized equivalent, from the","description":"The current poupança (savings account) monthly yield and its compounded annualized equivalent, from the\n    Central Bank's public series. Use for \"how much does poupança pay\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"poupanca_yieldArguments","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/clt_salary_calculator":{"post":{"operationId":"clt_salary_calculator","summary":"Net take-home pay for a CLT contract: progressive INSS contribution, IRRF withholding (with dependent","description":"Net take-home pay for a CLT contract: progressive INSS contribution, IRRF withholding (with dependent\n    deductions), the employer's FGTS deposit (informational — not part of net pay), and net salary; optionally the\n    13º salário net amount. Use for \"net salary on 5000 gross with 2 dependents\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gross_salary":{"description":"Monthly gross salary in R$.","exclusiveMinimum":0,"title":"Gross Salary","type":"number"},"dependents":{"default":0,"maximum":20,"minimum":0,"title":"Dependents","type":"integer"},"include_13th":{"default":true,"description":"Also show the 13º salário net calculation.","title":"Include 13Th","type":"boolean"}},"required":["gross_salary"],"title":"clt_salary_calculatorArguments","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/cdb_calculator":{"post":{"operationId":"cdb_calculator","summary":"CDB (bank certificate of deposit) return at a given % of CDI, with Brazil's regressive income tax on the","description":"CDB (bank certificate of deposit) return at a given % of CDI, with Brazil's regressive income tax on the\n    gain applied by holding period. Fetches the live annualized CDI if you don't supply one. Use for \"CDB at 110%\n    of CDI for 12 months on 10000\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"principal":{"description":"Amount invested, in R$.","exclusiveMinimum":0,"title":"Principal","type":"number"},"months":{"exclusiveMinimum":0,"maximum":360,"title":"Months","type":"integer"},"pct_of_cdi":{"default":100.0,"description":"e.g. 110 for 110% of CDI.","exclusiveMinimum":0,"maximum":300,"title":"Pct Of Cdi","type":"number"},"annual_cdi_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Override the annualized CDI; omit to fetch it live.","title":"Annual Cdi Pct"}},"required":["principal","months"],"title":"cdb_calculatorArguments","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/tesouro_selic_calculator":{"post":{"operationId":"tesouro_selic_calculator","summary":"Tesouro Selic (Brazilian government Selic-indexed treasury bond) return, with the regressive income tax on","description":"Tesouro Selic (Brazilian government Selic-indexed treasury bond) return, with the regressive income tax on\n    the gain and B3's custody fee (waived on the first R$10,000). Fetches the live Selic rate if you don't supply\n    one. Use for \"Tesouro Selic for 20000 over 2 years\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"principal":{"description":"Amount invested, in R$.","exclusiveMinimum":0,"title":"Principal","type":"number"},"months":{"exclusiveMinimum":0,"maximum":360,"title":"Months","type":"integer"},"annual_selic_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Override the Selic rate; omit to fetch it live.","title":"Annual Selic Pct"},"custody_fee_pct":{"default":0.2,"description":"B3 annual custody fee % (0.20 is standard).","maximum":2,"minimum":0,"title":"Custody Fee Pct","type":"number"}},"required":["principal","months"],"title":"tesouro_selic_calculatorArguments","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/fgts_calculator":{"post":{"operationId":"fgts_calculator","summary":"Projected FGTS account balance from the employer's 8% monthly deposits plus the fund's base interest,","description":"Projected FGTS account balance from the employer's 8% monthly deposits plus the fund's base interest,\n    compounded monthly. Use for \"FGTS balance after 3 years on a 4000 salary\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"monthly_salary":{"description":"Monthly gross salary in R$.","exclusiveMinimum":0,"title":"Monthly Salary","type":"number"},"months":{"exclusiveMinimum":0,"maximum":600,"title":"Months","type":"integer"},"starting_balance":{"default":0.0,"minimum":0,"title":"Starting Balance","type":"number"}},"required":["monthly_salary","months"],"title":"fgts_calculatorArguments","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/investment_comparison":{"post":{"operationId":"investment_comparison","summary":"Compare poupança, a CDB at a given % of CDI, and Tesouro Selic for the same amount and holding period, net","description":"Compare poupança, a CDB at a given % of CDI, and Tesouro Selic for the same amount and holding period, net\n    of tax and fees, ranked best to worst. Fetches live Selic/CDI/poupança rates. Use for \"compare poupança, CDB\n    and Tesouro Selic for 20000 over 2 years\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"principal":{"description":"Amount to invest, in R$.","exclusiveMinimum":0,"title":"Principal","type":"number"},"months":{"exclusiveMinimum":0,"maximum":360,"title":"Months","type":"integer"},"cdb_pct_of_cdi":{"default":100.0,"exclusiveMinimum":0,"maximum":300,"title":"Cdb Pct Of Cdi","type":"number"},"tesouro_custody_fee_pct":{"default":0.2,"maximum":2,"minimum":0,"title":"Tesouro Custody Fee Pct","type":"number"}},"required":["principal","months"],"title":"investment_comparisonArguments","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}}}}