CNPJ Validator Connector for AI agents.
3 live capabilities
Verify Brazilian business IDs and registration data instantly.
Waiting for input…
Why people use CNPJ Validator
CNPJ Validator for Brazilian Business Data Verification
Your agent takes the list, runs it through the validator, and gives you a clean table of valid IDs with their structure and state. You get a clean dataset in seconds.
What Vinkius changes
You get clean, verified Brazilian business data without manual entry or slow external lookups.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Cleaning up a messy CSV of leads
Someone has a list of 5,000 Brazilian leads and needs to know which ones are real.
- Real-world use case 02
Real-time form validation
A user is entering a business ID into a signup form.
- Real-world use case 03
Vendor data enrichment
An analyst needs to categorize vendors by state.
Complete set · 3capabilities
The complete CNPJ Validator capability set.
These are the exact actions your AI can choose when you ask it to work with CNPJ Validator.
01—03
3 capabilities in this set.
Part of 3 available through CNPJ Validator.
- 01 Capability
Analyze cnpj structure
Deconstructs a CNPJ into its constituent parts. It shows you exactly how the ID is built, including the root, branch, and check digits.
- 02 Capability
Batch validate cnpjs
Validates a large list of CNPJs at once. Use this to clean up massive CSV files or databases quickly to remove invalid entries.
- 03 Capability
Validate cnpj format
Checks if a specific CNPJ string is mathematically valid. It uses a checksum algorithm to catch typos or fake numbers immediately.
Set up in minutes
One URL. Then ask CNPJ Validator to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use CNPJ Validator from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_h5b23zF0Z9FsG4JVtouuZu9rJr0WPyPK7WWuZJWt/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it CNPJ Validator, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable CNPJ Validator for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_h5b23zF0Z9FsG4JVtouuZu9rJr0WPyPK7WWuZJWt/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the CNPJ Validator URL.
- Step 03
Save and start
Save the connection and enable CNPJ Validator in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"cnpj-validator": {
"url": "https://edge.vinkius.com/vk_preview_h5b23zF0Z9FsG4JVtouuZu9rJr0WPyPK7WWuZJWt/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using CNPJ Validator
Open Agent mode in chat and ask: "Using CNPJ Validator, help me...". 3 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"cnpj-validator": {
"url": "https://edge.vinkius.com/vk_preview_h5b23zF0Z9FsG4JVtouuZu9rJr0WPyPK7WWuZJWt/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using CNPJ Validator
Ask Copilot: "Using CNPJ Validator, help me...". 3 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"cnpj-validator": {
"url": "https://edge.vinkius.com/vk_preview_h5b23zF0Z9FsG4JVtouuZu9rJr0WPyPK7WWuZJWt/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using CNPJ Validator
Open Cascade and ask: "Using CNPJ Validator, help me...". 3 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"cnpj-validator": {
"url": "https://edge.vinkius.com/vk_preview_h5b23zF0Z9FsG4JVtouuZu9rJr0WPyPK7WWuZJWt/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using CNPJ Validator
Ask Cline: "Using CNPJ Validator, help me...". 3 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add cnpj-validator --transport http "https://edge.vinkius.com/vk_preview_h5b23zF0Z9FsG4JVtouuZu9rJr0WPyPK7WWuZJWt/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using CNPJ Validator
Ask Claude: "Using CNPJ Validator, show me...". 3 tools are ready
Where the request belongs
Work CNPJ Validator can move forward.
Data analysts in Brazil who are tired of messy spreadsheets and compliance officers who need to verify business IDs quickly.
Data Analyst
Cleans up thousands of rows of Brazilian lead data during a migration.
Compliance Officer
Verifies a list of new vendors to ensure they have valid registration numbers.
Fintech Developer
Builds a signup form that validates Brazilian business IDs in real-time.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse Connectors
NF-e Access Key Validator
Validate the structural integrity and compliance of Brazilian NF-e access keys.
NFe.io
Orchestrate NFe.io services. manage service invoices (NFS-e), validate city codes, and monitor company data directly from any AI agent.
PIS/COFINS Tax Calculator
Calculate PIS and COFINS tax liabilities for cumulative and non-cumulative regimes.
Simples Nacional Calculator
Calculate effective tax rates, Fator R eligibility, and monthly DAS amounts for the Brazilian Simples Nacional regime.
CPF/CNPJ Batch Processor
Validate, format, and clean Brazilian CPF and CNPJ identifiers in bulk.
BrasilAPI
Access Brazilian institutional data. audit CEP, CNPJ, and banks via AI.
Bring your own AI
Change the model, client or framework. Keep CNPJ Validator connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about CNPJ Validator.
The practical details behind the request, access and result.
Can the CNPJ Validator check if a Brazilian business ID is real?
Yes, it verifies if the number follows the correct mathematical rules and checksums. This helps you catch typos or fake numbers instantly.
How does the CNPJ Validator handle large lists of business numbers?
It can process a batch of identifiers at once. This is perfect for cleaning up thousands of rows in a CSV or database without doing them one by one.
Does the CNPJ Validator tell me which Brazilian state a company is in?
Yes, it can infer the registration state based on internal regional mapping rules. This saves you from having to look up the state manually.
Can I use the CNPJ Validator to clean up my existing database?
Absolutely. You can have your agent run your existing records through the validator to identify and remove any entries that are mathematically invalid.
Is the CNPJ Validator fast enough for real-time validation?
Yes, because it uses local algorithms instead of waiting for an external government API, it provides nearly instant results for your workflows.
What happens if I give the CNPJ Validator a number with a typo?
The validator will identify it as mathematically invalid. This allows your agent to flag the error for correction or remove it from your dataset.
Does this capability require an internet connection to the Brazilian Federal Revenue?
No. The validate_cnpj_format and other capabilities use a local checksum algorithm (weighted summation) to verify the mathematical validity of the CNPJ without making external API calls to federal databases.
Can I validate multiple CNPJs at once?
Yes, you can use the batch_validate_cnpjs capability to process an array of CNPJ strings in a single operation and receive summary statistics.
What information is returned when analyzing a CNPJ?
By using analyze_cnpj_structure, you will receive the root identifier, branch identifier, check digits, and the inferred Brazilian state (UF) based on regional mapping rules.
One connection away
Give your agent a direct line to CNPJ Validator.
Connect CNPJ Validator once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available