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

Build multi-step geography pipelines in LangChain by chaining IBGE Localidades — Cidades do Brasil data directly into your agent logic.

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 LangChain

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain geography data in LangChain

Pipe municipality data directly into your reasoning chains. You can call `get_municipios_por_uf` to grab a list of cities and immediately pass that array to a secondary prompt for regional analysis. Your agent handles the flow between tools without manual intervention. Each output becomes an input for the next step, letting you build complex data pipelines that process Brazilian geography in real-time.

Trace every tool call

LangSmith monitors every interaction with this MCP server. You see exactly how the agent builds its path when it triggers `get_municipio` or `list_regioes`. Debugging becomes a matter of inspecting the trace logs. You verify if the agent chose the right tool, check the raw JSON response from the API, and confirm the latency for each specific request.

Aggregate multiple servers

Combine this geography data with your existing databases or vector stores. The LangChain adapter lets you host this MCP server alongside other tools in a single execution environment. Your agent maintains context across different sources. It can cross-reference shipping zones from your SQL database with official administrative boundaries fetched via `list_estados`.

Setup guide

Set up IBGE Localidades — Cidades do Brasil MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes IBGE Localidades — Cidades do Brasil tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "ibge-localidades-cidades-do-brasil-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent IBGE Localidades — Cidades do Brasil transactions"
    })
    print(result["messages"][-1].content)

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 LangChain

Install the necessary adapters via pip and initialize the MultiServerMCPClient. You then pass the server endpoint to the client and register the tools directly into your LangChain agent definitions.

Yes. You can implement custom error handling within your LangGraph logic to manage potential timeouts or empty responses from the API. The agent can then retry the call or pivot to a different tool.

The server remains stateless, but you can maintain context using client.session() in your implementation. This allows the agent to remember previous queries during a multi-turn conversation.

No, you are limited only by your own rate-limiting logic and the performance of the underlying government API. The LangChain integration handles the tool mapping for all five available operations.

This server handles only public geographic information and requires zero authentication tokens. Your implementation remains secure because no sensitive user credentials are required to interact with the endpoints.

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