How to Use the World Bank Countries MCP in OpenAI Agents SDK

Q: Can I use World Bank Countries data with OpenAI Agents SDK for region filtering?

Absolutely. You run searchregions to get a list of geographic regions. Your agent then uses this specific metadata to narrow down the scope, making subsequent calls highly efficient.

Get global country data into your production agent system with OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect World Bank Countries MCP to OpenAI Agents SDK

Create your Vinkius account to connect World Bank Countries to OpenAI Agents SDK 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 World Bank Countries with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate World Bank Countries Data in Production

The `list_countries` tool gives you a clean list of all World Bank countries. You can use this data to validate inputs before your agent executes any core logic. It resolves country ISO codes and geographic regions, meaning you don't have to worry about manual lookups or inconsistent naming conventions in your deployed agent system.

Targeted Geographic Searches for OpenAI Agents SDK

Need data on specific groups? The `search_regions` tool lets agents filter World Bank countries by major geographic areas. This is useful when you only care about, say, Sub-Saharan Africa or Latin America. It provides the necessary metadata to scope your agent's attention, preventing it from wasting time querying irrelevant global data sets.

Check Global Income Levels with MCP Server

The `search_income_levels` tool checks a country's classification (HIC, LIC, etc.) based on World Bank standards. Your agent can use this to segment user requests or prioritize data retrieval. This mechanism helps ensure that the downstream logic only processes countries matching the required economic profile for your specific business case.

Setup guide

Set up World Bank Countries MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all World Bank Countries tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives World Bank Countries tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate World Bank Countries tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="World Bank Countries Agent",
            instructions="You have access to World Bank Countries tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 World Bank Open Data. 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 World Bank Countries 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 World Bank Countries MCP in OpenAI Agents SDK

The agent auto-discovers all tools on this MCP Server. When you call a tool like `list_countries`, the guardrails validate the action before it hits the API, giving you peace of mind that the data flow is secure.

Absolutely. You run `search_regions` to get a list of geographic regions. Your agent then uses this specific metadata to narrow down the scope, making subsequent calls highly efficient.

This server handles country ISO codes, global geographic regions, and income/lending classifications. These are all metadata strings that your agent reads and uses for validation.

Yeah. Since the tools are self-contained operations, you can chain them—like first listing countries, then filtering by income level. The agent manages this sequence for you.

The system's built-in guardrails validate all actions before execution. This means that even if your prompt is messy, the agent won't execute an invalid or unsafe API call.

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