Your AI agent now speaks CNPJ.
In under a minute, Claude, Cursor, Codex, and 40+ other agents start querying Brazilian company data, partners, Simples Nacional, and more. Without you writing a line of code.
What are Agent Skills?
Agent Skills is an open format, originally developed by Anthropic, for distributing procedural knowledge to AI agents. Instead of asking your agent to "read these docs first," you install a skill and it already knows how to work with the API: which endpoints to call, how to authenticate, and how to handle errors.
Learn more about Agent SkillsThree steps. Zero config.
Install the skill
Run the command in your project directory. Files land in .claude/skills, .cursor/skills, or wherever your agent looks.
Export your token
Create a free account, generate a token, and add CNPJ_API_TOKEN to your environment. Set once, works forever.
Ask in natural language
Say "look up CNPJ X" or "is this company in Simples Nacional?" and your agent picks the right endpoint, handles errors, and respects rate limits.
Works with every major AI agent
Compatible with any agent that supports the Agent Skills format, including IDE assistants, CLIs, and autonomous agents.
8 endpoints, all wired up
Full cnpj-api coverage: lookups, bulk enrichment, partner data, city and industry aggregates, Simples Nacional status, and usage monitoring.
CNPJ lookup
Full company profile: legal name, address, activities, partners, and logo.
Bulk lookup
Enrich up to 20 CNPJs in a single call (Pro plan).
Simples Nacional
MEI, ME, EPP status plus enrollment and exit dates.
Partners (sócios)
Partner profile and every company they are linked to.
City aggregates
IBGE stats with top companies by capital and recent registrations.
CNAE aggregates
Industry classification data for sector analysis.
Drop-in format
ReceitaWS and CNPJa response shapes for migration without changing code.
Usage & limits
Check active plan and current rate limit before kicking off a batch job.
Two paths, same result
Pick what matches your workflow. The full step-by-step lives in the docs.
Via CLI (terminal)
A single command installs the skill in Claude Code, Cursor, Codex, Windsurf, and other agents that run on your machine or IDE.
Open the full guideNEWManually on Claude.ai
Using Claude on the web or the desktop app? Upload the skill through the UI, no terminal required.
Open the full guideCommon questions
Do I need a paid plan?
No. The skill works with any plan, including the free tier. Only the bulk lookup endpoint requires Pro.
Which AI agents are supported?
Any agent compatible with the Agent Skills format. That includes Claude Code, Cursor, Codex, Windsurf, OpenCode, Amp, Antigravity, Cline, Gemini CLI, and 30+ others.
How does the agent get my token?
The skill instructs the agent to read CNPJ_API_TOKEN from the environment. You export it once and the agent never sees or stores the value.
Is the skill source open?
Yes. MIT license, public GitHub repo. You can audit, fork, and contribute new recipes.
Need a token to get started?
Create a free account and generate your first token in seconds. No credit card.
Create free account