Brazil IBGE CNAE 2.3 & Municipal Code B2B Tax Enricher (MCP Server + n8n Ready + REST API)

Enriches Brazilian CNAE 2.3 industry codes via official IBGE CONCLA APIs. Extracts permitted activities, tax exclusions, hierarchy (Section/Division/Class), and official 7-digit IBGE municipal codes for NF-e/NFS-e compliance.

Engineered by @b2b-quant-apis for scheduled Machine-to-Machine (n8n / Make.com) pipelines, Autonomous AI Agents (Claude Desktop, Cursor IDE, LangChain, CrewAI), and Enterprise Compliance & RevOps stacks.

---

Why Choose b2b-quant-apis/brazil-ibge-cnae-municipal-b2b-expansion-enricher?

1. Zero-Proxy & Zero-External-Key Architecture: Connects directly to official primary registries and public regulatory endpoints with deterministic input sanitization and automatic retry/backoff.
2. Quantitative Risk & Opportunity Scoring (0–100): Every output record includes a normalized quantitative score and an executive Markdown Dossier ready for RAG vector databases, Slack/Teams alerts, or CRM enrichment.
3. Native Model Context Protocol (MCP) Server: Connect directly to Claude Desktop, Cursor, Windsurf, or any MCP client in 1 click without deploying local infrastructure.
4. Predictable Pay-Per-Event Pricing: You only pay $0.015 USD per successfully processed record (cnae-municipality-enriched). Zero monthly subscription fees.

---

Transparent Pay-Per-Event (PPE) Pricing

Billing Event Name	Event Title	Price per Event (USD)	Categories
cnae-municipality-enriched	Brazil IBGE CNAE 2.3 Subclass & Tax Activity Enriched	$0.015 USD	AI, LEAD_GENERATION, BUSINESS

Negative Profit Protection: Failed queries, empty responses, or invalid inputs return cleanly without triggering event charges.

---

Input Parameters

Parameter	Type	Required	Default	Description
cnaeCodes	string	Yes	"6201501,4711302,8630503"	Comma-separated 7-digit Brazilian CNAE codes (e.g., '6201501, 4711302, 8630503').
targetUf	string	Optional	"SP"	Two-letter Brazilian state UF code (e.g., SP, RJ, MG, PR).
maxResults	integer	Optional	5	Maximum number of CNAE subclass records to return (1 to 50).

Example Input JSON

{
  "cnaeCodes": "6201501,4711302,8630503",
  "targetUf": "SP",
  "maxResults": 5
}

---

Output Dataset Schema

Each run pushes structured JSON items to the default Apify Dataset with the following fields:

Field Name	Type	Description
cnaeSubclassId	string	CNAE 7-Digit Code — Official 7-digit CNAE 2.3 subclass identifier.
cnaeDescription	string	Official CNAE Description — Official IBGE CONCLA subclass description.
sectionCode	string	Macro Section — IBGE macro economic section.
divisionDescription	string	Economic Division — IBGE 2-digit division description.
permittedActivitiesCount	integer	Permitted Activities Count — Total specific activities covered by this CNAE.
sampleActivities	string	Sample Covered Activities — Top activities included in this CNAE.
targetUf	string	Target State UF — Queried Brazilian state UF.
b2bFitScore	integer	B2B Tax & Expansion Fit Score (0-100) — Quantitative score for B2B segmentation and fiscal clarity (0-100).
markdownCnaeDossier	string	Markdown Fiscal & B2B Segmentation Dossier — Executive report for accountants, ERPs, and B2B lead segmentation.

Example Output JSON

[
  {
    "cnaeSubclassId": "Sample CNAE 7-Digit Code",
    "cnaeDescription": "Sample Official CNAE Description",
    "sectionCode": "Sample Macro Section",
    "divisionDescription": "Sample Economic Division",
    "permittedActivitiesCount": 92,
    "sampleActivities": "Sample Sample Covered Activities",
    "targetUf": "Sample Target State UF",
    "b2bFitScore": 92,
    "markdownCnaeDossier": "Sample Markdown Fiscal & B2B Segmentation Dossier"
  }
]

---

1-Click MCP Server Integration (Claude Desktop & Cursor IDE)

Add b2b-quant-apis/brazil-ibge-cnae-municipal-b2b-expansion-enricher as an AI Agent tool in Claude Desktop (claude_desktop_config.json) or Cursor IDE (.cursor/mcp.json):

{
  "mcpServers": {
    "brazil-ibge-cnae-municipal-b2b-expansion-enricher": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--actors",
        "b2b-quant-apis/brazil-ibge-cnae-municipal-b2b-expansion-enricher"
      ],
      "env": {
        "APIFY_TOKEN": "<YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}

• Hosted Streamable HTTP MCP URL: https://mcp.apify.com/?actors=b2b-quant-apis/brazil-ibge-cnae-municipal-b2b-expansion-enricher

---

Automated Daily n8n Workflow Template

Download the pre-built, sanitized n8n workflow template with a daily Schedule Trigger (07:00 AM), HTTP Request node, and CRM/Slack Webhook Router:

• Direct Download (.n8n.json): brazil-ibge-cnae-municipal-b2b-expansion-enricher.n8n.json
• Enterprise Multi-Actor Super-Pipelines: GitHub Repository jesleytassili-glitch/b2b-quant-mcp-n8n-suite

---

Direct Stateless REST API Call (cURL Synchronous JSON)

Call this Actor synchronously as a standard HTTP POST micro-API and receive the JSON dataset array directly in the HTTP response:

curl -X POST "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-ibge-cnae-municipal-b2b-expansion-enricher/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"cnaeCodes": "6201501,4711302,8630503", "targetUf": "SP", "maxResults": 5}'

---

Frequently Asked Questions (FAQ)

1. Do I need to configure residential proxies or third-party API keys?

No. b2b-quant-apis/brazil-ibge-cnae-municipal-b2b-expansion-enricher runs out-of-the-box with zero external API keys and zero paid proxy requirements.

2. Can I chain this Actor with other B2B compliance and lead enrichment tools?

Yes. Explore the full 25-Actor B2B Quant & Regulatory Suite at apify.com/b2b-quant-apis or import our 5 Multi-Actor Waterfall Pipelines from GitHub (jesleytassili-glitch/b2b-quant-mcp-n8n-suite).