Skip to content
Eden Engine

Brazilian Company Registry Lookup by CNPJ (BrasilAPI)

brasilapi/cnpj-lookup

Returns the Brazilian company registry record for one CNPJ (the 14-digit company tax number): legal name and trade name, registration status and date, address, main and secondary activity codes (CNAE), legal nature, size class, capital, tax-regime history, and the list of partners with their roles. Personal data: partner records (the `qsa` list) hold natural persons' names, partially masked CPF, age band and role, and for a sole proprietor (MEI or individual entrepreneur) the legal name, address, phone and email are the person's own. Lookup by CNPJ only, one per call; no search by name. Data from BrasilAPI, passed through unmodified and served by Eden Engine; not an official BrasilAPI product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

BrasilAPI

Data from BrasilAPI (brasilapi.com.br), an open-source community project that serves Brazilian public data. No credit is required by any terms found; crediting BrasilAPI is a courtesy. Served by Eden Engine; not an official BrasilAPI product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "brasilapi/cnpj-lookup" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "brasilapi/cnpj-lookup" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "brasilapi/cnpj-lookup", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "brasilapi/cnpj-lookup", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 20, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "cnpj"
  ],
  "properties": {
    "cnpj": {
      "type": "string",
      "pattern": "^[0-9]{14}$",
      "description": "The 14-digit CNPJ, digits only with no dots, slash or dash, keeping leading zeros, for example 19131243000197."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "cnpj",
    "razao_social"
  ],
  "properties": {
    "uf": {
      "type": "string",
      "description": "Two-letter state code."
    },
    "cep": {
      "type": "string"
    },
    "qsa": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Partners and administrators (quadro de socios e administradores), including personal names and a partially masked CPF."
    },
    "cnpj": {
      "type": "string",
      "description": "The 14-digit CNPJ."
    },
    "email": {
      "type": [
        "string",
        "null"
      ]
    },
    "porte": {
      "type": "string",
      "description": "Size class."
    },
    "bairro": {
      "type": "string"
    },
    "numero": {
      "type": "string"
    },
    "municipio": {
      "type": "string"
    },
    "logradouro": {
      "type": "string"
    },
    "cnae_fiscal": {
      "type": "integer",
      "description": "Main activity (CNAE) code."
    },
    "complemento": {
      "type": "string"
    },
    "razao_social": {
      "type": "string",
      "description": "Legal name."
    },
    "nome_fantasia": {
      "type": "string",
      "description": "Trade name; may be empty."
    },
    "capital_social": {
      "type": "number",
      "description": "Registered capital."
    },
    "ddd_telefone_1": {
      "type": "string"
    },
    "cnaes_secundarios": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Secondary activities, each with `codigo` and `descricao`."
    },
    "natureza_juridica": {
      "type": "string",
      "description": "Legal nature in words."
    },
    "regime_tributario": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Tax-regime history by year."
    },
    "situacao_cadastral": {
      "type": "integer",
      "description": "Registration status code."
    },
    "cnae_fiscal_descricao": {
      "type": "string",
      "description": "Main activity in words."
    },
    "data_inicio_atividade": {
      "type": "string",
      "description": "Date activity started, YYYY-MM-DD."
    },
    "data_situacao_cadastral": {
      "type": "string",
      "description": "Date the registration status took effect, YYYY-MM-DD."
    },
    "descricao_situacao_cadastral": {
      "type": "string",
      "description": "Registration status in words, for example ATIVA."
    },
    "descricao_identificador_matriz_filial": {
      "type": "string",
      "description": "MATRIZ (head office) or FILIAL (branch)."
    }
  },
  "description": "The company registry record for the CNPJ.",
  "additionalProperties": true
}