> ## 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.

# Cadastro

> Ferramenta MCP get_business da Base39.

Consulta gratuita de cadastro e endereço de uma empresa para todos os usuários, inclusive sem saldo. Preço: R\$ 0,00 (gratuito).

## Ferramenta

`get_business`

## Exemplo de chamada

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

## Exemplo de resultado

> [tab] Resumo
>
> ```markdown theme={null}
> ### Dados da empresa
>
> - **CNPJ:** 19131243000197
> - **Razão social:** Empresa de teste
> - **Nome fantasia:** Exemplo
> - **Situação cadastral:** Ativa
> - **Data da situação:** 2020-01-02
> - **Abertura:** 2020-01-02
> - **Natureza jurídica:** Sociedade Empresária Limitada
> - **Porte:** Microempresa (ME)
> - **Capital social:** 1234.56789
> - **Atividade principal:** 6201501
>
> #### Endereço
>
> - **Logradouro:** Rua de teste
> - **Número:** 0
> - **Bairro:** Centro
> - **CEP:** 01001000
> - **Município:** São Paulo
> - **UF:** SP
> ```

> [tab] Dados
>
> ```json theme={null}
> {
>   "object": "business",
>   "document": "19131243000197",
>   "legal_name": "Empresa de teste",
>   "trade_name": "Exemplo",
>   "registration_status": "Ativa",
>   "status_date": "2020-01-02",
>   "founded_at": "2020-01-02",
>   "legal_nature": "Sociedade Empresária Limitada",
>   "size": "Microempresa (ME)",
>   "capital": "1234.56789",
>   "address": {
>     "street": "Rua de teste",
>     "street_type": "RUA",
>     "number": "0",
>     "neighborhood": "Centro",
>     "postal_code": "01001000",
>     "city": "São Paulo",
>     "state": "SP"
>   },
>   "establishment_type": "Matriz",
>   "main_activity_code": "6201501",
>   "secondary_activity_codes": [
>     "6202300"
>   ],
>   "legal_nature_code": "2062",
>   "email": "contato@example.com",
>   "phones": [
>     {
>       "object": "phone",
>       "area_code": "11",
>       "number": "30001234",
>       "is_fax": false
>     }
>   ],
>   "simple_tax_opt_in": false,
>   "microentrepreneur_opt_in": false,
>   "officers": [
>     {
>       "object": "officer",
>       "document": "***123456**",
>       "name": "Pessoa de teste",
>       "qualification": "Sócio",
>       "joined_at": "2020-01-02",
>       "person_type": "Pessoa Física",
>       "age_range": "31 a 40 anos",
>       "country_code": "105",
>       "country": "BRASIL"
>     }
>   ],
>   "updated_at": "2026-11-01T00:00:00Z"
> }
> ```

> [accordion] Parâmetros
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "document": {
>       "type": "string",
>       "pattern": "^(?:[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": "CNPJ completo, com ou sem pontuação.",
>       "title": "CNPJ"
>     }
>   },
>   "required": [
>     "document"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "document": "19131243000197"
>     }
>   ]
> }
> ```

> [accordion] Resultado
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "object": {
>       "type": "string",
>       "const": "business",
>       "description": "Tipo do objeto: empresa."
>     },
>     "document": {
>       "type": "string",
>       "minLength": 1,
>       "description": "CPF ou CNPJ informado pela fonte; pode estar mascarado."
>     },
>     "legal_name": {
>       "type": "string",
>       "minLength": 1,
>       "description": "Razão social."
>     },
>     "trade_name": {
>       "type": "string",
>       "description": "Nome fantasia."
>     },
>     "registration_status": {
>       "type": "string",
>       "description": "Situação cadastral, preservada conforme a fonte."
>     },
>     "status_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 situação cadastral, em YYYY-MM-DD."
>     },
>     "founded_at": {
>       "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 de abertura, em YYYY-MM-DD."
>     },
>     "legal_nature": {
>       "type": "string",
>       "description": "Natureza jurídica."
>     },
>     "size": {
>       "type": "string",
>       "description": "Porte da empresa."
>     },
>     "capital": {
>       "type": "string",
>       "pattern": "^-?\\d+(?:\\.\\d+)?$",
>       "description": "Capital social em reais, como texto decimal, preservando a precisão informada."
>     },
>     "main_activity": {
>       "type": "string",
>       "description": "Atividade econômica principal."
>     },
>     "address": {
>       "description": "Endereço cadastral, quando informado.",
>       "type": "object",
>       "properties": {
>         "street": {
>           "type": "string",
>           "description": "Logradouro."
>         },
>         "street_type": {
>           "type": "string",
>           "description": "Tipo de logradouro."
>         },
>         "number": {
>           "type": "string",
>           "description": "Número do endereço."
>         },
>         "complement": {
>           "type": "string",
>           "description": "Complemento do endereço."
>         },
>         "neighborhood": {
>           "type": "string",
>           "description": "Bairro."
>         },
>         "postal_code": {
>           "type": "string",
>           "description": "Código postal."
>         },
>         "city": {
>           "type": "string",
>           "description": "Município."
>         },
>         "state": {
>           "type": "string",
>           "description": "Unidade federativa."
>         },
>         "country": {
>           "type": "string",
>           "description": "País informado pela fonte."
>         },
>         "active": {
>           "type": "boolean",
>           "description": "Indica se o endereço está ativo na fonte."
>         }
>       },
>       "additionalProperties": false
>     },
>     "establishment_type": {
>       "type": "string",
>       "description": "Indica matriz ou filial."
>     },
>     "main_activity_code": {
>       "type": "string",
>       "description": "Código CNAE da atividade principal."
>     },
>     "secondary_activity_codes": {
>       "type": "array",
>       "items": {
>         "type": "string"
>       },
>       "description": "Códigos CNAE das atividades secundárias."
>     },
>     "legal_nature_code": {
>       "type": "string",
>       "description": "Código da natureza jurídica."
>     },
>     "email": {
>       "type": "string",
>       "description": "Endereço de e-mail."
>     },
>     "phones": {
>       "type": "array",
>       "items": {
>         "type": "object",
>         "properties": {
>           "object": {
>             "type": "string",
>             "const": "phone",
>             "description": "Tipo do objeto Base39."
>           },
>           "area_code": {
>             "type": "string",
>             "description": "Código de área do telefone."
>           },
>           "number": {
>             "type": "string",
>             "description": "Número de identificação."
>           },
>           "is_fax": {
>             "type": "boolean",
>             "description": "Indica telefone de fax."
>           }
>         },
>         "required": [
>           "object",
>           "is_fax"
>         ],
>         "additionalProperties": false
>       },
>       "description": "Telefones informados."
>     },
>     "simple_tax_opt_in": {
>       "type": "boolean",
>       "description": "Opção pelo Simples Nacional, conforme informada."
>     },
>     "simple_tax_opted_at": {
>       "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 opção pelo Simples Nacional."
>     },
>     "microentrepreneur_opt_in": {
>       "type": "boolean",
>       "description": "Opção pelo MEI, conforme informada."
>     },
>     "microentrepreneur_opted_at": {
>       "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 opção pelo MEI."
>     },
>     "officers": {
>       "type": "array",
>       "items": {
>         "type": "object",
>         "properties": {
>           "object": {
>             "type": "string",
>             "const": "officer",
>             "description": "Tipo do objeto: sócio ou administrador."
>           },
>           "document": {
>             "type": "string",
>             "minLength": 1,
>             "description": "CPF ou CNPJ informado pela fonte; pode estar mascarado."
>           },
>           "name": {
>             "type": "string",
>             "description": "Nome do sócio ou administrador."
>           },
>           "qualification": {
>             "type": "string",
>             "description": "Qualificação societária."
>           },
>           "joined_at": {
>             "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 de entrada na sociedade, em YYYY-MM-DD."
>           },
>           "ownership_percent": {
>             "type": "number",
>             "description": "Participação percentual informada pela fonte."
>           },
>           "person_type": {
>             "type": "string",
>             "description": "Tipo de pessoa do sócio."
>           },
>           "age_range": {
>             "type": "string",
>             "description": "Faixa etária do sócio."
>           },
>           "country_code": {
>             "type": "string",
>             "description": "Código do país do sócio."
>           },
>           "country": {
>             "type": "string",
>             "description": "País do sócio."
>           },
>           "representative_document": {
>             "type": "string",
>             "description": "Documento mascarado do representante legal, conforme publicado."
>           },
>           "representative_name": {
>             "type": "string",
>             "description": "Nome do representante legal."
>           },
>           "representative_qualification": {
>             "type": "object",
>             "properties": {
>               "object": {
>                 "type": "string",
>                 "const": "code_description",
>                 "description": "Tipo do objeto Base39."
>               },
>               "code": {
>                 "type": "string",
>                 "description": "Código de identificação."
>               },
>               "description": {
>                 "type": "string",
>                 "description": "Descrição informada."
>               }
>             },
>             "required": [
>               "object"
>             ],
>             "additionalProperties": false,
>             "description": "Qualificação do representante legal."
>           }
>         },
>         "required": [
>           "object"
>         ],
>         "additionalProperties": false
>       },
>       "description": "Sócios e administradores, com CPF mascarado para pessoas físicas."
>     },
>     "city_code": {
>       "type": "string",
>       "description": "Código do município cadastral."
>     },
>     "country_code": {
>       "type": "string",
>       "description": "Código do país cadastral."
>     },
>     "activities": {
>       "type": "array",
>       "items": {
>         "type": "object",
>         "properties": {
>           "object": {
>             "type": "string",
>             "const": "business_activity",
>             "description": "Tipo do objeto Base39."
>           },
>           "code": {
>             "type": "string",
>             "description": "Código de identificação."
>           },
>           "description": {
>             "type": "string",
>             "description": "Descrição informada."
>           },
>           "is_primary": {
>             "type": "boolean",
>             "description": "Indica a atividade econômica principal."
>           }
>         },
>         "required": [
>           "object"
>         ],
>         "additionalProperties": false
>       },
>       "description": "Atividades econômicas com código, descrição e indicação da atividade principal."
>     },
>     "responsible_qualification": {
>       "type": "object",
>       "properties": {
>         "object": {
>           "type": "string",
>           "const": "code_description",
>           "description": "Tipo do objeto Base39."
>         },
>         "code": {
>           "type": "string",
>           "description": "Código de identificação."
>         },
>         "description": {
>           "type": "string",
>           "description": "Descrição informada."
>         }
>       },
>       "required": [
>         "object"
>       ],
>       "additionalProperties": false,
>       "description": "Qualificação do responsável pela empresa."
>     },
>     "federative_entity": {
>       "type": "string",
>       "description": "Ente federativo responsável."
>     },
>     "simple_tax_excluded_at": {
>       "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 de exclusão do Simples Nacional."
>     },
>     "microentrepreneur_excluded_at": {
>       "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 de exclusão do MEI."
>     },
>     "registration_status_reason": {
>       "type": "object",
>       "properties": {
>         "object": {
>           "type": "string",
>           "const": "code_description",
>           "description": "Tipo do objeto Base39."
>         },
>         "code": {
>           "type": "string",
>           "description": "Código de identificação."
>         },
>         "description": {
>           "type": "string",
>           "description": "Descrição informada."
>         }
>       },
>       "required": [
>         "object"
>       ],
>       "additionalProperties": false,
>       "description": "Motivo da situação cadastral."
>     },
>     "foreign_city": {
>       "type": "string",
>       "description": "Nome da cidade no exterior."
>     },
>     "special_status": {
>       "type": "string",
>       "description": "Situação especial informada no cadastro."
>     },
>     "special_status_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 situação especial."
>     },
>     "updated_at": {
>       "type": "string",
>       "format": "date-time",
>       "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
>       "description": "Data e hora da última atualização publicada, em ISO 8601."
>     }
>   },
>   "required": [
>     "object",
>     "document",
>     "legal_name",
>     "updated_at"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "object": "business",
>       "document": "19131243000197",
>       "legal_name": "Empresa de teste",
>       "trade_name": "Exemplo",
>       "registration_status": "Ativa",
>       "status_date": "2020-01-02",
>       "founded_at": "2020-01-02",
>       "legal_nature": "Sociedade Empresária Limitada",
>       "size": "Microempresa (ME)",
>       "capital": "1234.56789",
>       "address": {
>         "street": "Rua de teste",
>         "street_type": "RUA",
>         "number": "0",
>         "neighborhood": "Centro",
>         "postal_code": "01001000",
>         "city": "São Paulo",
>         "state": "SP"
>       },
>       "establishment_type": "Matriz",
>       "main_activity_code": "6201501",
>       "secondary_activity_codes": [
>         "6202300"
>       ],
>       "legal_nature_code": "2062",
>       "email": "contato@example.com",
>       "phones": [
>         {
>           "object": "phone",
>           "area_code": "11",
>           "number": "30001234",
>           "is_fax": false
>         }
>       ],
>       "simple_tax_opt_in": false,
>       "microentrepreneur_opt_in": false,
>       "officers": [
>         {
>           "object": "officer",
>           "document": "***123456**",
>           "name": "Pessoa de teste",
>           "qualification": "Sócio",
>           "joined_at": "2020-01-02",
>           "person_type": "Pessoa Física",
>           "age_range": "31 a 40 anos",
>           "country_code": "105",
>           "country": "BRASIL"
>         }
>       ],
>       "updated_at": "2026-11-01T00:00:00Z"
>     }
>   ]
> }
> ```


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