Skip to content
Eden Engine
Get started

Brazilian Company Lookup by CNPJ (Registry Status, Activities, Address, Partners)

receitawscnpj/lookup-cnpj

The Brazilian federal registry record of one company by its CNPJ number (14 digits, no punctuation): legal name (nome), trade name (fantasia), registration status (situacao) and date, headquarters or branch (tipo), opening date, size (porte), legal nature, main and secondary economic activities (CNAE codes), address, email and phone as registered, share capital, Simples Nacional and MEI status, and the partners and administrators (qsa) with their roles. A CNPJ whose check digits are wrong or that the registry rejects is refused as invalid. Answers are kept for an hour. Registry data republished by ReceitaWS and served by Eden Engine; not an official Receita Federal or ReceitaWS 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 $0.50.

Data source

Receita Federal (CNPJ register)

Company registry data of the Brazilian Receita Federal (CNPJ register), as published by ReceitaWS (receitaws.com.br). Served by Eden Engine; not an official Receita Federal or ReceitaWS 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.

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

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

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "receitawscnpj/lookup-cnpj", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "receitawscnpj/lookup-cnpj", 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 21, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "cnpj"
  ],
  "properties": {
    "cnpj": {
      "type": "string",
      "pattern": "^[0-9]{14}$",
      "description": "The company's CNPJ as 14 digits with no dots, slash or hyphen, for example 27865757000102. Keep leading zeros."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "cnpj",
    "nome"
  ],
  "properties": {
    "uf": {
      "type": "string"
    },
    "cep": {
      "type": "string"
    },
    "qsa": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "nome": {
            "type": "string"
          },
          "qual": {
            "type": "string",
            "description": "Role with its code, for example 49-Sócio-Administrador."
          }
        },
        "additionalProperties": true
      },
      "description": "Partners and administrators."
    },
    "cnpj": {
      "type": "string",
      "description": "The CNPJ formatted with punctuation."
    },
    "nome": {
      "type": "string",
      "description": "Legal name (razão social)."
    },
    "tipo": {
      "type": "string",
      "description": "MATRIZ (headquarters) or FILIAL (branch)."
    },
    "email": {
      "type": "string"
    },
    "porte": {
      "type": "string",
      "description": "Company size class."
    },
    "simei": {
      "type": "object",
      "description": "MEI (SIMEI) status: optante and its dates.",
      "additionalProperties": true
    },
    "bairro": {
      "type": "string"
    },
    "numero": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "description": "OK for a returned record."
    },
    "simples": {
      "type": "object",
      "description": "Simples Nacional status: optante and its dates.",
      "additionalProperties": true
    },
    "abertura": {
      "type": "string",
      "description": "Opening date, DD/MM/YYYY."
    },
    "fantasia": {
      "type": "string",
      "description": "Trade name; may be empty."
    },
    "situacao": {
      "type": "string",
      "description": "Registration status, for example ATIVA."
    },
    "telefone": {
      "type": "string"
    },
    "municipio": {
      "type": "string"
    },
    "logradouro": {
      "type": "string"
    },
    "complemento": {
      "type": "string"
    },
    "data_situacao": {
      "type": "string",
      "description": "Date of that status, DD/MM/YYYY."
    },
    "capital_social": {
      "type": "string",
      "description": "Share capital in reais, as a string."
    },
    "motivo_situacao": {
      "type": "string"
    },
    "natureza_juridica": {
      "type": "string",
      "description": "Legal nature with its code."
    },
    "ultima_atualizacao": {
      "type": "string",
      "description": "When ReceitaWS last refreshed the record (ISO 8601, UTC)."
    },
    "atividade_principal": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "text": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "atividades_secundarias": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "text": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    }
  },
  "description": "The registry record. Dates are DD/MM/YYYY text, amounts are strings.",
  "additionalProperties": true
}