IBGE Agregados (SIDRA) MCP Server for Mastra AIGive Mastra AI instant access to 5 tools to Get Localidades, Get Metadados, Get Periodos, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect IBGE Agregados (SIDRA) through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The IBGE Agregados (SIDRA) MCP Server for Mastra AI is a standout in the Data Analytics category — giving your AI agent 5 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"ibge-agregados-sidra": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "IBGE Agregados (SIDRA) Agent",
instructions:
"You help users interact with IBGE Agregados (SIDRA) " +
"using 5 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with IBGE Agregados (SIDRA)?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About IBGE Agregados (SIDRA) MCP Server
Connect to the IBGE SIDRA (System for Automatic Recovery) database and explore Brazil's official statistical aggregates through natural language. This server provides a direct interface to the most comprehensive source of Brazilian demographic and economic data.
Mastra's agent abstraction provides a clean separation between LLM logic and IBGE Agregados (SIDRA) tool infrastructure. Connect 5 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Survey Discovery — List and filter IBGE aggregates (tables) by subject, period, or classification to find exactly the data you need.
- Metadata Inspection — Retrieve detailed metadata for specific tables to understand the context and methodology of the data.
- Variable Analysis — Identify all available variables within an aggregate to prepare precise data queries.
- Temporal Coverage — Check available time periods for any survey to build historical series or snapshots.
- Geographic Granularity — Discover which territorial levels (National, State, City, etc.) are available for specific datasets.
The IBGE Agregados (SIDRA) MCP Server exposes 5 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 5 IBGE Agregados (SIDRA) tools available for Mastra AI
When Mastra AI connects to IBGE Agregados (SIDRA) through Vinkius, your AI agent gets direct access to every tool listed below — spanning brazil, demographics, statistics, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Get localidades on IBGE Agregados (SIDRA)
Get available geographic levels for an aggregate
Get metadados on IBGE Agregados (SIDRA)
Get metadata for a specific aggregate
Get periodos on IBGE Agregados (SIDRA)
Get available time periods for an aggregate
Get variaveis on IBGE Agregados (SIDRA)
Get variables for a specific aggregate
List agregados on IBGE Agregados (SIDRA)
Allows multidimensional filtering. List IBGE aggregates (surveys/tables)
Connect IBGE Agregados (SIDRA) to Mastra AI via MCP
Follow these steps to wire IBGE Agregados (SIDRA) into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the IBGE Agregados (SIDRA) MCP Server
Mastra AI provides unique advantages when paired with IBGE Agregados (SIDRA) through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add IBGE Agregados (SIDRA) without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every IBGE Agregados (SIDRA) tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
IBGE Agregados (SIDRA) + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the IBGE Agregados (SIDRA) MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query IBGE Agregados (SIDRA), process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed IBGE Agregados (SIDRA) as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query IBGE Agregados (SIDRA) on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using IBGE Agregados (SIDRA) tools alongside other MCP servers
Example Prompts for IBGE Agregados (SIDRA) in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with IBGE Agregados (SIDRA) immediately.
"List all IBGE aggregates related to 'PIB' (GDP)."
"What variables are available for aggregate 1737?"
"Show me the available geographic levels for aggregate 5932."
Troubleshooting IBGE Agregados (SIDRA) MCP Server with Mastra AI
Common issues when connecting IBGE Agregados (SIDRA) to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpIBGE Agregados (SIDRA) + Mastra AI FAQ
Common questions about integrating IBGE Agregados (SIDRA) MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Quip
12 toolsConnect Quip to your AI to search documents, read threads, view messages, and edit content seamlessly.
folk
6 toolsManage relationships across sales, recruiting, and partnerships with a lightweight CRM that syncs contacts from everywhere.
Oppo Game Open Platform
8 toolsManage Oppo Game Open Platform distribution — validate logins, query orders, and report game data directly from any AI agent.
Chaindesk
11 toolsBuild no-code AI agents trained on your own data that handle customer support, lead qualification, and FAQ resolution.