SR

Serasa Recomenda — Credit Limit Recommendations MCP Connector for Claude

A+

Generate credit-grant decisions and recommended limits for CPF and CNPJ across nine distribution channels.

4 tools Updated Oct 1, 2026 Official Vinkius Partner

Recomenda is Serasa Experian's decision-as-a-service for credit granting. Submit a CPF or CNPJ with the operation amount and receive a proposal number, a recommended credit limit, a risk level and a sales orientation. This connector covers all nine distribution channels — direct, distribuidor, distribuidor_prorede, ecommerce, ecommerce_relatorio, erp, erp_relatorio, consumo_externo and large — each with its own request path and accepted fields. Unsupported optional fields for the chosen channel are dropped automatically so a request never fails on a schema mismatch. Optional enrichment modules (score, negative annotations, estimated revenue or income) are selected through informacoes_adicionais. Proposals can be retrieved individually, listed with history on e-commerce channels, and exported as a recommendations report. Authentication is OAuth2 client credentials issued at developer.serasaexperian.com.br.

serasaexperiancredit-limitcredit-decisionbrazilpfpjrecommendation

4 tools expose this connector's capabilities to your AI agent.

generate_recommendations_report

With no filters it returns the whole base, so narrow it with nome/cnpj/data_inicio/data_fim/user_id/status/numero_proposta. Status codes are 04, 06 and 07. Export a report of PJ (CNPJ) recommendations, filterable by name, document, proposal number, user or status

get_proposal

" identifier returned by recommend_credit_limit. Pass the same channel and document_type used at creation so the request hits the right path. Fetch a previously generated recommendation by its proposal number (numeroProposta)

list_proposals

Filters: `busca` matches name or document, `status` matches the recommendation status, and `data_inicio` / `data_fim` bound the creation date (ISO 8601). Page with pagina_atual / tamanho_pagina (defaults 0 and 5). Use this to recover a proposal number before get_proposal. List the credit recommendations already generated, with date, document and status filters

recommend_credit_limit

`channel` is the distribution model of the proposal — pick the one that matches how the credit is sold: direct, distribuidor, distribuidor_prorede, ecommerce, ecommerce_relatorio, erp, erp_relatorio, consumo_externo or large. `cod_tipo_venda`: 1 = new customer, 2 = recurring customer. `politica`: 1 or 2 (risk policy version). Not every channel accepts every optional field — unsupported ones for the chosen channel are dropped automatically. `informacoes_adicionais` selects extra modules as a JSON object, e.g. {"anotacoesCompletas": true, "rendaEstimada": true, "faturamentoEstimado": true}. Generate a credit-grant recommendation and suggested credit limit for a CPF or CNPJ

See how to talk to your AI agent using Serasa Recomenda — Credit Limit Recommendations.

Recommend a credit limit for CNPJ 33014556000196 for a 1500 operation on the direct channel, recurring customer.

Calls recommend_credit_limit with channel direct, document_type PJ, document 33014556000196, valor_operacao 1500 and cod_tipo_venda 2, then returns the proposal number, recommended limit, risk level and sales orientation.

What limit would Serasa suggest for this new customer, including score and negative annotations?

Calls recommend_credit_limit with cod_tipo_venda 1 and informacoes_adicionais {"anotacoesCompletas": true} so score and negative-annotation modules come back with the recommendation.

List the proposals we generated for that CNPJ through the distributor-prorede channel.

Calls list_proposals with channel distribuidor_prorede and document_type PJ, which hits the flat /distribuidor-prorede/propostas path and returns the stored proposals.

The channel mirrors how the credit is sold: direct for your own sales team, distribuidor or distribuidor_prorede for a dealer network, ecommerce / ecommerce_relatorio for online checkout, erp / erp_relatorio when the request comes from an ERP, consumo_externo for third-party consumption and large for high-value operations.

Related Connectors