IBGE Economia — CNAE Activities MCP. Map any business activity to its official Brazilian code.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
IBGE Economia — CNAE Activities provides mastery over Brazil's economic taxonomy. It gives your agent the tools to navigate the 1,332 CNAE activity codes across 21 sectors, 87 divisions, and 285 groups.
Use this to classify businesses for tax registration, compliance, and deep market analysis.
What your AI agents can do
Get subclasse cnae
Retrieves the name and details for a single, specific CNAE subclass code.
List classes cnae
Lists all CNAE classes that fall under a given Division code.
List divisoes cnae
Lists all CNAE divisions contained within a selected top-level Section code.
Retrieves a complete list of the 21 primary economic sectors (A-U) that define Brazilian business activity.
Narrows the search by listing all specific industries (Divisions) contained within a selected economic Section.
Gets a list of detailed business activity groupings (Classes) that fall under a specific Division.
Finds the most specific operational codes (Subclasses) associated with a given CNAE Class.
Retrieves the full name and details for a single, specific CNAE subclass code.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
IBGE Economia — CNAE Activities: 5 Tools for Code Mapping
These tools allow your agent to systematically navigate the full CNAE hierarchy, from top-level sectors down to the final subclass code.
019d75b6get subclasse cnae
Retrieves the name and details for a single, specific CNAE subclass code.
019d75b6list classes cnae
Lists all CNAE classes that fall under a given Division code.
019d75b6list divisoes cnae
Lists all CNAE divisions contained within a selected top-level Section code.
019d75b6list secoes cnae
Lists all 21 top-level economic sections (A-U) of the CNAE taxonomy.
019d75b6list subclasses por classe
Lists all available subclasses under a specific CNAE Class code.
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
Make Your AI Do More
Start with IBGE Economia — CNAE Activities, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
Your AI client needs to map any business activity to the proper code in Brazil's CNAE system. This server gives your agent complete access to the 1,332 CNAE activity codes, covering 21 sectors, 87 divisions, and 285 groups. It's perfect for tax registration, compliance checks, and deep market analysis.
list_secoes_cnae gives you a complete list of the 21 primary economic sectors (A-U) that define Brazilian business activity.
list_divisoes_cnae lets you narrow the search by listing all specific industries (Divisions) contained within a selected top-level Section.
list_classes_cnae gets you a list of detailed business activity groupings (Classes) that fall under a specific Division.
list_subclasses_por_classe finds the most specific operational codes (Subclasses) associated with a given CNAE Class.
get_subclasse_cnae retrieves the full name and details for a single, specific CNAE subclass code.
How IBGE Economia — CNAE Activities MCP Works
- 1 Start by listing the highest level of detail you need, usually by calling
list_secoes_cnaeto get the top 21 economic sections. - 2 Then, use the resulting Section code to narrow the scope by calling
list_divisoes_cnae, and repeat this process down the hierarchy until you reach the desired Class. - 3 Finally, use
list_subclasses_por_classeorget_subclasse_cnaewith the final code to get the complete classification details.
The bottom line is that the server forces a systematic, step-by-step traversal of the CNAE hierarchy, ensuring you don't skip any required classification levels.
Who Is IBGE Economia — CNAE Activities MCP For?
Compliance officers and market analysts need this. If your job involves figuring out what legal code a company needs—whether it's for tax, licensing, or market reporting—you're here. You're tired of cross-referencing government PDFs and guessing which section applies. This lets your AI agent handle the deep, structured lookups instantly.
Determines the correct CNAE code for new clients or business units, ensuring the code matches local tax and licensing regulations.
Builds competitive reports by mapping the economic activity of different companies to their specific CNAE codes for comparative analysis.
Writes Python code that must validate business activity codes against the official CNAE taxonomy before processing financial transactions.
What Changes When You Connect
- Deep Classification: Use
list_secoes_cnaeto start at the top. You instantly get the 21 primary sectors (A-U), giving you the broadest view of the Brazilian economy. - Structured Drilldown: The
list_divisoes_cnaetool lets you move from a broad section (like 'Commerce') down to a specific industry (like 'Retail Trade'), maintaining perfect hierarchical structure. - Targeted Scope: When you know the division,
list_classes_cnaecuts the search space dramatically. It only returns the relevant, detailed activity groupings for that specific industry. - Granular Detail:
list_subclasses_por_classepulls the most specific operational codes. This is where you find the precise code needed for compliance or tax filing. - Final Verification: Use
get_subclasse_cnaeto pull the full, clean data record for a subclass. This confirms the name and scope before your agent commits to a code.
Real-World Use Cases
Determining a new company's required tax code
A startup needs to register its IT consulting arm. Instead of guessing, it asks the agent: 'What CNAE code for IT consulting?' The agent uses list_secoes_cnae (finds 'J' for IT), then list_divisoes_cnae (finds '62'), list_classes_cnae (narrows to consulting), and finally get_subclasse_cnae to return the exact, compliant code.
Comparing industry sectors for a market report
A market analyst wants to compare the size of the food packaging industry versus the electronics sector. The agent uses list_secoes_cnae and list_divisoes_cnae to isolate the relevant codes for each, then uses list_classes_cnae to build a comparative list of the 285 groups.
Validating a client's existing business code
A compliance officer receives a code (e.g., 4711-3/01) and needs to verify its full description and hierarchy. The agent uses get_subclasse_cnae to pull the complete, official description and trace the code back up through the taxonomy.
Building a code validation pipeline
A fintech developer needs to ensure that any incoming business code is valid. The agent first calls list_secoes_cnae to confirm the top-level sector exists, then systematically calls through the remaining tools (list_divisoes_cnae, list_classes_cnae, etc.) to verify the full code path integrity.
The Tradeoffs
Calling a tool blindly
Just calling list_classes_cnae without specifying the parent division. The server will fail or return an error because it needs the Division code to narrow the search.
→
Always start at the top. First, use list_secoes_cnae to find the correct Sector. Then, use list_divisoes_cnae to find the Division. Only then can you pass the Division code to list_classes_cnae.
Assuming a direct lookup
Asking the agent for a subclass code without specifying the parent class or division. This oversimplifies the complex, multi-layered regulatory structure.
→
You must follow the hierarchy. Start with the highest scope possible, using list_secoes_cnae, and progressively pass the results to the next tool until you reach the final subclass.
Using a general search tool
Trying to search the entire CNAE database using a single, non-hierarchical query. This ignores the structured, mandated path of classification.
→
The server requires a structured path. Use the sequence: list_secoes_cnae $ o$ list_divisoes_cnae $ o$ list_classes_cnae $ o$ list_subclasses_por_classe.
When It Fits, When It Doesn't
Use this server if your job requires precise, multi-step classification within the Brazilian economic framework. Specifically, if you need to know the exact, compliant code for tax, licensing, or market grouping, this is your tool. It forces you to validate the code path (Section $ o$ Division $ o$ Class $ o$ Subclass).
Don't use this if you just need a general understanding of 'what kind of business it is.' For that, a general search or text embedding tool is better. Also, if you are building a system that only needs to validate a code that already exists in a simple internal database, you don't need the full complexity. Stick to this when you must adhere to the official, rigid IBGE taxonomy.
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
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 server provides 5 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Figuring out a business code shouldn't require navigating 10 different government PDFs.
Before this, if you needed to classify a company, you opened the IBGE portal. You'd hunt through massive documents, clicking between sections, cross-referencing codes, and manually confirming the path from a top-level sector down to the specific subclass. It was slow, manual, and one wrong click meant a compliance headache.
Now, your agent handles the entire process. You just tell it the business activity. It runs the full sequence of tools, traversing the 21 sections and 1,332 subclasses automatically. You get the precise, official CNAE code, ready for use.
The IBGE Economia — CNAE Activities MCP Server gives you the definitive code.
You no longer need to copy-paste codes from multiple sources or manually check the dependencies between sections and divisions. The server manages the strict, required flow for you.
It moves the classification process from a manual, high-risk auditing task to a single, reliable API call sequence. It's just that simple.
Common Questions About IBGE Economia — CNAE Activities MCP
How do I use the `list_secoes_cnae` tool with IBGE Economia — CNAE Activities? +
Run list_secoes_cnae to get the list of the 21 top-level economic sectors (A-U). This is always the best place to start when you have no idea where the business activity falls.
What is the difference between `list_classes_cnae` and `list_subclasses_por_classe`? +
The difference is scope. list_classes_cnae finds the detailed grouping (the Class) under a Division. list_subclasses_por_classe finds the final, granular code (the Subclass) under that Class.
Can I get details for a specific code using `get_subclasse_cnae`? +
Yes, get_subclasse_cnae accepts a subclass code and returns its full, official description and name. This is the quickest way to confirm a specific code's meaning.
What if I need to find the division first? +
Use list_divisoes_cnae. You need to pass it a Section code first, so remember the sequence: Section $ o$ Division.
How do I use `list_divisoes_cnae` to find all specific industries in a given section? +
This tool lists all divisions under a specified CNAE section. You provide the section code (e.g., 'A' for Agriculture), and it returns a list of all 87 divisions, letting you pinpoint the specific industry area you need.
What should I do if the `get_subclasse_cnae` tool returns an error code? +
If you get an error, check the provided code format against the IBGE documentation. The tool requires a valid hierarchy path (Section > Division > Group > Class) to return accurate subclass data. Double-check your inputs.
Can I use `list_subclasses_por_classe` to check if a specific subclass exists? +
Yes, you can use this tool to list all subclasses under a given class. If the subclass you're looking for isn't in the returned list, it means the code is either invalid or doesn't exist in the current taxonomy.
Is there a way to list all CNAE classes within a specific division using `list_classes_cnae`? +
Absolutely. Pass the desired division code to list_classes_cnae. It returns every available group and class code within that division, giving you a full map of all possible sub-sectors.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
DataForSEO
Manage SERP data via DataForSEO — track Google organic rankings, audit Maps nodes, monitor News publications, and research Amazon products directly from any AI agent.
HERE (Location & Maps)
Build with location data via HERE — geocode addresses, calculate routes, track traffic, and get weather.
Google Search Console
Monitor your website's search performance, fix indexing issues, and manage sitemaps via AI.
You might also like
Faker Data Generator
Generate realistic fake data in seconds — names, emails, addresses, credit cards, companies, and more. 60+ locales including Brazilian Portuguese. The most complete data generator in the ecosystem, with 5M+ weekly downloads.
OpenPanel
Track events, identify users, and manage profile properties directly from your AI agent using OpenPanel analytics.
RandomUser API
Generate random user data — audit personas and locations via AI.