CNAE Activities MCP for AI. Map any Brazilian economic code instantly.

Q: How do I find all possible CNAE codes for a given industry division using listdivisoescnae?

To start listing divisions, first call listsecoescnae to pick the relevant top section. Then use listdivisoescnae with that selected section ID to pull all available industries within it.

Q: Can I use getsubclassecnae to validate a code?

Absolutely. Calling getsubclassecnae is the final step in validation. It confirms that a specific, precise subclass code exists within the entire system and provides its full context.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Connect to your AI in seconds.

IBGE Economia — CNAE Activities provides immediate access to Brazil's official economic classification system. It maps over 1,300 specific codes across 21 sectors, 87 divisions, and 285 groups.

This is the definitive resource for anyone needing accurate tax, licensing, or market research data based on Brazilian business activity.

What your AI can do

List secoes cnae

Retrieves the list of all 21 top-level CNAE economic sectors (A through U).

List divisoes cnae

Lists specific industries that fall under a broader economic section.

List classes cnae

Lists all general business classes within a defined industry division.

+ 2 more capabilities included

Identify the highest-level industry sector

Finds and lists all 21 top-tier economic sectors (A through U) used for grouping business types.

Map specific industries within a sector

Lists detailed divisions that fall under a chosen top-level economic section.

Pinpoint granular business groups and classes

Narrows the focus by listing all potential operational groups or general classes belonging to an established industry division.

Retrieve highly specific activity codes

Gets the final, most detailed subclass code (the 1,332 options) for precise compliance documentation.

Ask an AI about this

Included with Plan

Waiting for input…

AI Agent

IBGE Economia — CNAE Activities: 5 Tools

These five tools allow your agent to systematically navigate the entire CNAE classification hierarchy, from top-level sectors down to specific business subclasses.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using IBGE Economia — CNAE Activities on Vinkius

List Secoes Cnae

Retrieves the list of all 21 top-level CNAE economic sectors (A through U).

List Divisoes Cnae

Lists specific industries that fall under a broader economic section.

List Classes Cnae

Lists all general business classes within a defined industry division.

Get Subclasse Cnae

Retrieves specific details for an individual CNAE subclass code.

List Subclasses Por Classe

Lists every specific subclass option available within a given business class.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

Start a conversation

Open a new chat. The CNAE Activities integration is available immediately — no restart needed.

Antigravity

Configure Agent Environment

Open your Antigravity agent's workspace configuration or mcp-servers.json file.

Bind the Endpoint

Add the Vinkius endpoint URL to your agent's MCP connections list:

"mcp_servers": {
  "ibge-economia-cnae-activities": {
    "serverUrl": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
  }
}

Provide your secure token in place of [YOUR_TOKEN_HERE] to ensure your agent requests are authenticated.

Execute

Start your Antigravity session. The agent will autonomously discover and utilize the CNAE Activities tools with full Vinkius guardrails applied.

VS Code Copilot

⚡

One-Click Install (Recommended)

In your Vinkius Dashboard, simply click the Add to VS Code button for this server. We'll automatically configure your local workspace.

Or configure manually

Open MCP Settings

Open VS Code, press Ctrl/Cmd + Shift + P, and search for GitHub Copilot: MCP Servers.

Add Server Config

Add the Vinkius endpoint configuration to your mcp-servers.json file:

"ibge-economia-cnae-activities": {
  "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}

Ensure you replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

LangChain

Install Dependencies

Install the LangChain MCP adapters for your environment:

pip install langchain-mcp-adapters

Connect the Server

Use the SSEClient in LangChain to connect to the Vinkius managed endpoint:

from langchain_mcp_adapters.client import SSEClient

# Connect to Vinkius
client = SSEClient(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
tools = client.get_tools()

CrewAI

Define the Tool

Load the Vinkius MCP tools into your CrewAI agents:

from crewai import Agent
from mcp_crewai import MCPTool

# Connect securely to Vinkius
vinkius_tools = MCPTool(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

# Assign to Agent
researcher = Agent(
    role='Data Researcher',
    tools=vinkius_tools.get_all()
)

Execute Task

Run your CrewAI process. The agent will autonomously route tasks to the Vinkius managed server.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on every call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with IBGE Economia — CNAE Activities, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 5,100+ others, all in one place
Add new capabilities to your AI anytime you want
Every connection is secured and compliant automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog every week

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by IBGE. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This connection provides 5 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Dealing with complex industry codes used to be a nightmare.

Before this, if you needed to classify a new business activity, you were stuck. You'd have to open massive PDFs or navigate dozens of government websites. This meant copying and pasting details into spreadsheets, cross-referencing sections, and manually verifying that the code you found was appropriate for tax filing or licensing. It was slow, error-prone work.

Now, your agent does it all in plain conversation. You tell it what the business *does*, and it systematically walks through the CNAE hierarchy using specialized tools like `list_secoes_cnae` and subsequent calls to map out the exact code for you. The output is clean, structured data ready to use.

Using CNAE Activities with the IBGE Economia — CNAE Activities MCP

The painful steps—like having to remember which division falls under which section or manually searching through hundreds of subclasses—are gone. You simply tell your agent, 'I need the code for X,' and it executes the precise sequence using tools like `list_divisoes_cnae` then `list_classes_cnae`.

The result is immediate structural certainty. It's not just a number; it’s verifiable context. You know exactly where that business stands in Brazil's economy, and you get the structured data instantly.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

What your AI can actually do with this

The CNAE system governs how every economic activity in Brazil registers. If you're dealing with compliance, tax filing, or deep market analysis, you need to know the exact classification code—there’s no guessing here. This MCP gives your agent mastery over that entire taxonomy, letting it drill down through sectors (like Agriculture or Finance) all the way to a specific subclass used on a CNPJ registration.

Instead of juggling massive government PDFs and trying to manually find the right section, you just ask for the activity. Your AI client handles the traversal across the complex structure—from the top-level sector down through divisions, groups, and classes. This level of detail is critical for accurate business modeling, whether you’re building a compliance tool or running competitive analysis.

You connect everything via Vinkius, getting immediate access to this deep layer of Brazilian economic data.

Built · Hosted · Managed by Vinkius CNAE Activities MCP - Map Brazilian Economic Codes

Server ID 019d75b6-9ee7-70a6-b892-31bbec52dfb6

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

Here's how it actually works

The bottom line is that it turns a multi-step, manual government lookup process into a single, structured conversation with your agent.

First, you ask your agent to list all major economic sections using list_secoes_cnae to set the general scope.

Next, based on a selected section, you call list_divisoes_cnae to narrow down the industry focus (e.g., from 'Commerce' to 'Retail Trade').

Finally, you drill down using list_classes_cnae or list_subclasses_por_classe until your agent retrieves the exact code details via get_subclasse_cnae.

What Changes When You Connect

Stop relying on outdated industry guides. You can immediately check the required scope by calling list_secoes_cnae to establish the highest level of classification first.

Avoid manual data entry errors when classifying businesses. By systematically calling tools like list_divisoes_cnae, your agent handles the complex parent-child relationship for you.

Drill down from broad sectors to specific codes with confidence. The combination of list_classes_cnae and list_subclasses_por_classe ensures you get to the precise 1,332 subclass level needed for compliance.

Validate business inputs in real time. If a client submits an activity code, your agent can use get_subclasse_cnae to verify its existence and context against the official taxonomy.

Build better internal tools. Instead of hard-coding classification logic, you integrate this MCP, allowing your application to dynamically navigate the entire CNAE structure.

See it in action

01 01

Onboarding a new client company

A compliance officer needs to verify if a tech startup's services match an existing code. They ask their agent, which uses list_secoes_cnae to start in IT, then drills down through the appropriate divisions and classes until it confirms the correct subclass using get_subclasse_cnae.

02 02

Comparing market segments

A market analyst wants to see how many different retail types exist under 'Commerce.' They prompt their agent, which executes list_divisoes_cnae and then uses list_classes_cnae across that division to build a comprehensive comparison list.

03 03

Validating product lines

A manufacturer is expanding its product scope. To ensure they cover all bases, their agent runs through the entire hierarchy, calling list_subclasses_por_classe for every relevant class to guarantee no code gaps are missed.

04 04

Automating tax registration data prep

A developer builds a tool that accepts a general activity description. The agent uses the MCP's sequence of tools—starting with list_secoes_cnae and progressing downward—to output the structured, official CNAE code ready for database insertion.

The honest tradeoffs

Guessing the correct code

Anti-pattern

A user simply types 'selling stuff' into an AI client and asks it to give a code. The agent responds with an educated guess that might be incorrect for tax purposes.

The Fix

Don’t rely on general conversation. To get the definitive answer, your agent must systematically navigate the hierarchy: first call list_secoes_cnae, then follow the path down through divisions and classes using tools like list_divisoes_cnae before asking for the final subclass details via get_subclasse_cnae.

Treating it as a single search bar

Anti-pattern

Thinking that one API call can return all 1,300+ codes at once. This is computationally impossible and unreliable.

The Fix

The CNAE structure requires traversal. You must use the specialized tools in order: start broad with list_secoes_cnae, then narrow the scope using list_divisoes_cnae to maintain data integrity.

When It Fits, When It Doesn't

Use this MCP if your project absolutely requires accurate, verifiable classification against Brazil's official CNAE taxonomy. This is mandatory for compliance software, financial reporting tools, and regulated industries. If you only need a general idea of an industry (e.g., 'It’s probably tech'), use a simple web search or a generic AI model—it will be good enough. But if you are submitting data that must pass regulatory checks, this is the only reliable source. Don't try to build the entire lookup structure yourself; let your agent call list_secoes_cnae and then systematically traverse using the other tools to guarantee accuracy.

Questions you might have

How do I find all possible CNAE codes for a given industry division using list_divisoes_cnae? +

To start listing divisions, first call list_secoes_cnae to pick the relevant top section. Then use list_divisoes_cnae with that selected section ID to pull all available industries within it.

What is the best way to find a subclass code for tax compliance? +

The most reliable method is sequential traversal. Start by calling list_secoes_cnae, then move down through divisions, classes (using list_classes_cnae), and finally request subclasses using list_subclasses_por_classe or get_subclasse_cnae.

Do I need to use list_secoes_cnae before calling any other tool? +

Yes, generally. The CNAE structure is hierarchical. Starting with list_secoes_cnae establishes the highest-level context, which helps your agent correctly inform subsequent calls like list_divisoes_cnae.

Can I use get_subclasse_cnae to validate a code? +

Absolutely. Calling get_subclasse_cnae is the final step in validation. It confirms that a specific, precise subclass code exists within the entire system and provides its full context.

If I provide an invalid division code when calling list_classes_cnae, how should my agent handle the error? +

The MCP returns a specific API error detailing the bad input. Your AI client catches this failure and provides a clear message like 'Invalid Division Code.' You can build explicit logic to prompt the user for corrected data.

I need to list every single subclass code across all groups; how do I prevent hitting rate limits when running many calls to list_subclasses_por_classe? +

We recommend batch processing or iterating through classes in chunks. The underlying system supports pagination, so your agent only needs to track the continuation token rather than making repeated requests.

Does running list_secoes_cnae guarantee that I am retrieving the most current CNAE structure available for compliance? +

Since this MCP pulls data directly from IBGE's official source, it maintains high authority. However, regulatory bodies occasionally update codes, so always verify major changes against the original IBGE documentation.

What specific format must my input take when calling get_subclasse_cnae to ensure I retrieve the correct details? +

The tool requires a complete and valid code string formatted as 'XXXX-X/XX.' Providing just the class or group level will result in an invalid response; you need the full subclass identifier.

Why do I need CNAE codes? +

CNAE is mandatory for every business operating in Brazil. It determines your tax regime (Simples Nacional, Lucro Presumido), eligible activities for MEI registration, CNPJ registration, municipal licensing, and regulatory compliance.

Connect to your AI in seconds.

List secoes cnae

List divisoes cnae

List classes cnae

IBGE Economia — CNAE Activities: 5 Tools

Make your AI actually useful.

List Secoes Cnae

List Divisoes Cnae

List Classes Cnae

Get Subclasse Cnae

List Subclasses Por Classe

Security and governance baked right in.

Claude AI

Open Claude Settings

Add Custom Connector

Start a conversation

Claude Code

Open your terminal

Add the MCP Server

Start coding

Cursor

One-Click Install (Recommended)

Open Cursor Settings

Add New Server

Use in Composer

Antigravity

Configure Agent Environment

Bind the Endpoint

Execute

VS Code Copilot

One-Click Install (Recommended)

Open MCP Settings

Add Server Config

Windsurf

One-Click Install (Recommended)

Open Windsurf Settings

Add Server Endpoint

LangChain

Install Dependencies

Connect the Server

CrewAI

Define the Tool

Execute Task

Choose How to Get Started

Build Your Own

Make Your AI Do More

Works with Claude, ChatGPT, Cursor, and more

Dealing with complex industry codes used to be a nightmare.

Using CNAE Activities with the IBGE Economia — CNAE Activities MCP

What your AI can actually do with this

Here's how it actually works

Who is this actually for?

What Changes When You Connect

See it in action

Onboarding a new client company

Comparing market segments

Validating product lines

Automating tax registration data prep

The honest tradeoffs

Guessing the correct code

Treating it as a single search bar

When It Fits, When It Doesn't

Questions you might have