How to Use the IBGE Localidades — Cidades do Brasil MCP in LlamaIndex

Index Brazilian geography into LlamaIndex using IBGE Localidades — Cidades do Brasil for grounded, semantic retrieval.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IBGE Localidades — Cidades do Brasil MCP to LlamaIndex

Create your Vinkius account to connect IBGE Localidades — Cidades do Brasil to LlamaIndex 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 IBGE Localidades — Cidades do Brasil with LlamaIndex

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Semantic indexing for LlamaIndex

Convert API responses into searchable knowledge. Use `get_municipio` to pull detailed records and index them into your vector store for future semantic queries. Your RAG application gains access to structured geographic data. Instead of relying on general training, your agent retrieves facts grounded in the specific IBGE dataset.

Automate data updates

Set up your pipeline to refresh the index periodically. By calling `list_regioes_metropolitanas`, you can keep your local knowledge base current with the latest administrative definitions. The system automatically parses the tool output into chunks. This ensures that your agent answers user questions based on the most recent state of the data.

Filter tools for specific tasks

Restrict the agent to only use specific tools like `list_estados`. This prevents the model from wasting tokens on irrelevant calls when it only needs a list of states. You define the allowed set within the McpToolSpec. This keeps your agent focused and improves the accuracy of the final query results.

Setup guide

Set up IBGE Localidades — Cidades do Brasil MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all IBGE Localidades — Cidades do Brasil MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to IBGE Localidades — Cidades do Brasil tools.",
)
response = await agent.run("List recent IBGE Localidades — Cidades do Brasil data")

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 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.

Why Choose Vinkius

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

Connect IBGE Localidades — Cidades do Brasil 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 IBGE Localidades — Cidades do Brasil MCP in LlamaIndex

Use the llama-index-tools-mcp package to instantiate a BasicMCPClient. Once connected, convert the tools to a list and pass them to your FunctionAgent for immediate use.

Yes, you can configure the agent to call the tools live during a query. This is ideal if you need the absolute latest data instead of relying on the indexed version.

The latency depends on the API response time for the specific tool called. You can mitigate this by caching tool outputs in your vector store if you don't need real-time data.

Yes, you can merge the tools with your existing document readers. This creates a hybrid search environment where the agent pulls facts from both the API and your uploaded files.

The server transmits public geographic records over standard connections. Since it touches no private user info, the risk is negligible, and the system relies on standard transport layer security.

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