> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base39.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Serasa

> Ferramenta MCP get_serasa da Base39.

Retorna as negativações Serasa por CPF ou CNPJ, com registros e resumos por categoria. Requer a integração configurada na organização. Preço: R\$ 20,80. Valor por consulta.

## Ferramenta

`get_serasa`

## Exemplo de chamada

```json theme={null}
{
  "method": "tools/call",
  "params": {
    "name": "get_serasa",
    "arguments": {
      "document": "00000000000191"
    }
  }
}
```

## Exemplo de resultado

> [tab] Resumo
>
> ```markdown theme={null}
> ### Negativações
>
> Categoria | Quantidade | Valor total
> --- | --- | ---
> pefin | 0 | R$ 0,00
> refin | 1 | R$ 105.556,56
> notary | 0 | R$ 0,00
> ```

> [tab] Dados
>
> ```json theme={null}
> {
>   "object": "list",
>   "document": "00000000000191",
>   "data": [
>     {
>       "object": "negative_record",
>       "type": "refin",
>       "date": "2026-08-30",
>       "amount": "105556.56",
>       "modality": "CREDITO E FINANCIAMENTO-FINANCEIRA",
>       "contract": "CONTRATO-EXEMPLO-001",
>       "creditor": "Credor Exemplo",
>       "principal": true
>     },
>     {
>       "object": "negative_record",
>       "type": "collection_records",
>       "date": "2026-07-26",
>       "amount": "12500",
>       "modality": "DUPLIC DE VENDA MERCANTIL",
>       "contract": "CONTRATO-EXEMPLO-001",
>       "creditor": "Credor Exemplo",
>       "principal": true,
>       "under_judgment": false
>     },
>     {
>       "object": "negative_record",
>       "type": "collection_records",
>       "date": "2026-07-26",
>       "amount": "12500",
>       "modality": "DUPLIC DE VENDA MERCANTIL",
>       "contract": "CONTRATO-EXEMPLO-001",
>       "creditor": "Credor Exemplo",
>       "principal": true,
>       "under_judgment": false
>     }
>   ],
>   "summary": [
>     {
>       "type": "pefin",
>       "count": 0,
>       "amount": "0"
>     },
>     {
>       "type": "refin",
>       "count": 1,
>       "amount": "105556.56"
>     },
>     {
>       "type": "notary",
>       "count": 0,
>       "amount": "0"
>     }
>   ]
> }
> ```

> [accordion] Parâmetros
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "document": {
>       "type": "string",
>       "pattern": "^(?:\\d{11}|\\d{3}\\.\\d{3}\\.\\d{3}-\\d{2}|[0-9A-Za-z]{12}\\d{2}|[0-9A-Za-z]{2}\\.[0-9A-Za-z]{3}\\.[0-9A-Za-z]{3}\\/[0-9A-Za-z]{4}-\\d{2})$",
>       "description": "CPF ou CNPJ completo, com ou sem pontuação.",
>       "title": "CPF ou CNPJ"
>     },
>     "state": {
>       "title": "UF",
>       "description": "Sigla da unidade federativa, com duas letras maiúsculas.",
>       "type": "string",
>       "pattern": "^[A-Z]{2}$"
>     }
>   },
>   "required": [
>     "document"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "document": "00000000000191"
>     }
>   ]
> }
> ```

> [accordion] Resultado
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "object": {
>       "type": "string",
>       "const": "list",
>       "description": "Coleção de negativações."
>     },
>     "document": {
>       "type": "string",
>       "minLength": 1,
>       "description": "CPF ou CNPJ informado pela fonte; pode estar mascarado."
>     },
>     "data": {
>       "type": "array",
>       "items": {
>         "type": "object",
>         "properties": {
>           "object": {
>             "type": "string",
>             "const": "negative_record",
>             "description": "Ocorrência de negativação."
>           },
>           "type": {
>             "type": "string",
>             "description": "Categoria da ocorrência."
>           },
>           "date": {
>             "type": "string",
>             "format": "date",
>             "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
>             "description": "Data da ocorrência, em YYYY-MM-DD."
>           },
>           "amount": {
>             "type": "string",
>             "pattern": "^-?\\d+(?:\\.\\d+)?$",
>             "description": "Valor da ocorrência em reais, como texto decimal."
>           },
>           "modality": {
>             "type": "string",
>             "description": "Modalidade da dívida informada."
>           },
>           "contract": {
>             "type": "string",
>             "description": "Identificador do contrato da dívida informado."
>           },
>           "creditor": {
>             "type": "string",
>             "description": "Nome do credor informado."
>           },
>           "principal": {
>             "type": "boolean",
>             "description": "Indica se a pessoa consultada é a devedora principal."
>           },
>           "city": {
>             "type": "string",
>             "description": "Município da ocorrência."
>           },
>           "state": {
>             "type": "string",
>             "description": "Unidade federativa da ocorrência."
>           },
>           "notary": {
>             "type": "string",
>             "description": "Cartório informado para o protesto."
>           },
>           "disputed": {
>             "type": "boolean",
>             "description": "Indicação explícita de contestação da ocorrência."
>           },
>           "under_judgment": {
>             "type": "boolean",
>             "description": "Indicação explícita de discussão judicial."
>           }
>         },
>         "required": [
>           "object",
>           "type"
>         ],
>         "additionalProperties": false
>       },
>       "description": "Ocorrências disponibilizadas pela consulta."
>     },
>     "summary": {
>       "type": "array",
>       "items": {
>         "type": "object",
>         "properties": {
>           "type": {
>             "type": "string",
>             "description": "Categoria dos registros negativos."
>           },
>           "count": {
>             "description": "Quantidade de ocorrências informada.",
>             "type": "integer",
>             "minimum": 0,
>             "maximum": 9007199254740991
>           },
>           "amount": {
>             "type": "string",
>             "pattern": "^-?\\d+(?:\\.\\d+)?$",
>             "description": "Montante em reais, como texto decimal, preservando a precisão informada."
>           },
>           "status": {
>             "type": "string",
>             "description": "Situação informada pela fonte."
>           }
>         },
>         "required": [
>           "type"
>         ],
>         "additionalProperties": false
>       },
>       "description": "Totais informados por categoria; podem existir sem detalhes individuais."
>     }
>   },
>   "required": [
>     "object",
>     "document",
>     "data",
>     "summary"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "object": "list",
>       "document": "00000000000191",
>       "data": [
>         {
>           "object": "negative_record",
>           "type": "refin",
>           "date": "2026-08-30",
>           "amount": "105556.56",
>           "modality": "CREDITO E FINANCIAMENTO-FINANCEIRA",
>           "contract": "CONTRATO-EXEMPLO-001",
>           "creditor": "Credor Exemplo",
>           "principal": true
>         },
>         {
>           "object": "negative_record",
>           "type": "collection_records",
>           "date": "2026-07-26",
>           "amount": "12500",
>           "modality": "DUPLIC DE VENDA MERCANTIL",
>           "contract": "CONTRATO-EXEMPLO-001",
>           "creditor": "Credor Exemplo",
>           "principal": true,
>           "under_judgment": false
>         },
>         {
>           "object": "negative_record",
>           "type": "collection_records",
>           "date": "2026-07-26",
>           "amount": "12500",
>           "modality": "DUPLIC DE VENDA MERCANTIL",
>           "contract": "CONTRATO-EXEMPLO-001",
>           "creditor": "Credor Exemplo",
>           "principal": true,
>           "under_judgment": false
>         }
>       ],
>       "summary": [
>         {
>           "type": "pefin",
>           "count": 0,
>           "amount": "0"
>         },
>         {
>           "type": "refin",
>           "count": 1,
>           "amount": "105556.56"
>         },
>         {
>           "type": "notary",
>           "count": 0,
>           "amount": "0"
>         }
>       ]
>     }
>   ]
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.