Companies (Brazil)

Signed, verified Brazilian company registry data as MCP tools for Claude. CNPJ profiles, partner records (QSA — quadro societário), and CNAE economic-activity lookups, all sourced from BrasilAPI (which mirrors Receita Federal).

Endpoint: https://companies.mcp.signed-data.org/mcp Domain spec: companies.brazil

This is a query-driven product — there is no scheduled ingestion. Every CNPJ lookup is fetched and signed at request time. The CDS signature proves that BrasilAPI returned this data at the query timestamp.

Quick start

{
  "mcpServers": {
    "signeddata-companies": {
      "url": "https://companies.mcp.signed-data.org/mcp"
    }
  }
}

curl -X POST https://companies.mcp.signed-data.org/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

pip install signeddata-cds
pip install "git+https://github.com/signed-data/cds.git#subdirectory=mcp/companies"
signeddata-mcp-companies

git clone https://github.com/signed-data/cds.git && cd cds
pip install -e sdk/python
pip install -e mcp/companies
signeddata-mcp-companies

Tools

Tool	Description
`get_company_profile`	Full CNPJ profile — razão social, situação cadastral, endereço, capital social, CNAE
`get_company_partners`	Partner / shareholder records (QSA) for a CNPJ
`check_company_status`	Quick `ATIVA` / `BAIXADA` status check
`validate_cnpj_tool`	Validate CNPJ check digits without making any API call
`get_cnae_info`	Look up an economic-activity (CNAE) code
`batch_company_lookup`	Look up up to 10 CNPJs in one call

CNPJ validation

All lookups validate the CNPJ check digits before making any API call. Invalid CNPJs short-circuit with an error response and never reach BrasilAPI. Use validate_cnpj_tool to validate without consuming a request.

Content types

Schema	Content type URI
`profile.cnpj`	`https://signed-data.org/vocab/companies-brazil/profile-cnpj`
`partners.cnpj`	`https://signed-data.org/vocab/companies-brazil/partners-cnpj`
`cnae.profile`	`https://signed-data.org/vocab/companies-brazil/cnae-profile`

Data source

Source	URL	Auth	License
BrasilAPI	`brasilapi.com.br`	None	MIT

Environment variables

Variable	Description	Default
`CDS_PRIVATE_KEY_PATH`	Path to RSA private key for signing	(unsigned if not set)
`CDS_PUBLIC_KEY_PATH`	Path to RSA public key for verification	(skip verification)
`CDS_ISSUER`	Issuer URI in signed events	`signed-data.org`