Ferramenta
get_business
Exemplo de chamada
{
"method": "tools/call",
"params": {
"name": "get_business",
"arguments": {
"document": "19131243000197"
}
}
}
Exemplo de resultado
O objeto abaixo é retornado emstructuredContent.
{
"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"
}
Schema dos parâmetros
Schema dos parâmetros
{
"$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"
}
]
}
Schema do resultado
Schema do resultado
{
"$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"
}
]
}