Buscador De Cnpj

What is Buscador De Cnpj?

Buscador De Cnpj is an MCP server that queries Brazilian company data using the API from buscadordecnpj.com. It offers free public CNPJ lookups and premium features requiring an API key. It is intended for users who need to retrieve and search Brazilian business registry information.

How to use Buscador De Cnpj?

Install automatically via a curl script or manually via pip/uv. Configure the Claude Desktop JSON file with the path to uvx (or the installed package) and set the CNPJ_API_KEY environment variable for premium features. Then restart Claude Desktop. Use natural language commands or direct tool calls like cnpj_public_lookup with a CNPJ number.

Key features of Buscador De Cnpj

• Free public CNPJ lookup with no API key required
• Premium detailed lookup with full company data
• Textual term search using natural language
• Advanced search with structured filters and pagination
• Bulk lookup of multiple CNPJs with optional state/active filters

Use cases of Buscador De Cnpj

• Quickly retrieve basic company data from a CNPJ for free
• Perform detailed due diligence on Brazilian businesses
• Search for companies by name, location, or activity status
• Bulk-check multiple CNPJs for account validation or auditing

FAQ from Buscador De Cnpj

What tools does Buscador De Cnpj provide?

It provides cnpj_public_lookup (free), cnpj_detailed_lookup (premium), term_search, cnpj_advanced_search, and cnpj_bulk_lookup.

Is an API key required for all features?

No. Only premium features (cnpj_detailed_lookup, term_search, cnpj_advanced_search, cnpj_bulk_lookup) require an API key from buscadordecnpj.com. Public lookups are free and unlimited.

How do I install Buscador De Cnpj?

Use the automatic installer: curl -sSL https://raw.githubusercontent.com/victortavernari/buscador-de-cnpj/main/install.sh | bash. Alternatively, install via pip install buscador-de-cnpj or with uv.

What configuration is needed for Claude Desktop?

Add an mcpServers entry in claude_desktop_config.json with the command (e.g., uvx or the installed package) and the CNPJ_API_KEY environment variable if using premium features.

How do I debug the server?

Use the MCP Inspector: run npx @modelcontextprotocol/inspector uvx buscador-de-cnpj (or buscador-de-cnpj if installed globally) to test tools locally.