How to Use the Brasil.io MCP in Claude Code

Q: How do I add the Brasil.io MCP Server to Claude Code?

Run the command claude mcp add --transport http brasilio -- in your terminal, replacing with your Vinkius endpoint. Use claude mcp list to verify that the server and its tools are active.

Q: Can I use Claude Code to export Brasil.io data to CSV?

Yes, you can instruct Claude Code to run querytabledata and write the output directly to a local CSV file. The agent handles the JSON parsing and file writing entirely in your terminal.

Q: How does Claude Code handle large query results from Brasil.io?

Claude Code uses the pagination controls in querytabledata to fetch data in manageable batches. This prevents your terminal buffer from overflowing during large data exports.

Pipe live Brasil.io public datasets directly into your terminal workflows using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Brasil.io MCP to Claude Code

Create your Vinkius account to connect Brasil.io to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Brasil.io with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query public tables directly from the command line

The `query_table_data` tool allows Claude Code to fetch specific records from Brazilian public databases directly inside your terminal session. You can pass raw JSON filters to isolate specific states, cities, or dates. This terminal-first MCP Server tool lets you pipe the retrieved records directly into local shell scripts or JSON files. The agent executes the request, processes the raw payload, and outputs clean data ready for command-line processing.

List and paginate datasets through the terminal

The `list_datasets` tool exposes the entire catalog of available Brazilian public tables to your command-line agent. Claude Code reads this list to locate specific datasets without requiring a browser. The agent handles the raw pagination parameters automatically. It filters through the available tables and outputs the exact dataset names you need for your shell commands.

Extract table structures for automated scripts

The `get_table_metadata` tool retrieves the column names and data types of any table in the registry. Claude Code uses this schema information to construct precise queries for your automated pipelines. By checking the metadata first, your CLI agent ensures that automated scripts do not break due to unexpected schema changes. It verifies the structure before running bulk queries, saving terminal execution time.

Setup guide

Set up Brasil.io MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see brasilio-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Brasil.io transactions." It will automatically discover and invoke the available Brasil.io tools.

Terminal

claude mcp add --transport http brasilio-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Brasil.io MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "brasilio-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Brasil.io. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Brasil.io now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Brasil.io MCP in Claude Code

Run the command `claude mcp add --transport http brasilio -- ` in your terminal, replacing `` with your Vinkius endpoint. Use `claude mcp list` to verify that the server and its tools are active.

Yes, you can instruct Claude Code to run `query_table_data` and write the output directly to a local CSV file. The agent handles the JSON parsing and file writing entirely in your terminal.

Claude Code uses the pagination controls in `query_table_data` to fetch data in manageable batches. This prevents your terminal buffer from overflowing during large data exports.

Yes, because Claude Code runs headless in the terminal. You can write scripts that trigger the agent to fetch updated public records using the MCP Server on a schedule.

Yes, the MCP Server only processes the specific query parameters needed to fetch public records. Your local environment variables, shell history, and terminal configurations are never exposed to the public API.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript