OpenDataSUS MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 8 tools to Datastore Search, Group List, Organization List, and more
GDPR Free for SubscribersThe OpenAI Agents SDK enables production-grade agent workflows in Python. Connect OpenDataSUS through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The OpenDataSUS MCP Server for OpenAI Agents SDK is a standout in the Data Analytics category — giving your AI agent 8 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="OpenDataSUS Assistant",
instructions=(
"You help users interact with OpenDataSUS. "
"You have access to 8 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from OpenDataSUS"
)
print(result.final_output)
asyncio.run(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 OpenDataSUS MCP Server
Connect to the OpenDataSUS portal to explore and analyze Brazilian public health information through natural language. This server interfaces with the CKAN-based API of the Ministry of Health.
The OpenAI Agents SDK auto-discovers all 8 tools from OpenDataSUS through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries OpenDataSUS, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Dataset Discovery — List all available datasets, search for specific health topics (like COVID-19 or vaccination), and browse by tags or categories.
- Metadata Inspection — Retrieve detailed metadata for packages and individual resources to understand data provenance and structure.
- Deep Data Querying — Use the DataStore search to filter and retrieve actual rows from CSV and Excel resources directly into your conversation.
- Organizational Browsing — List data providers and organizations to find specific departmental records.
The OpenDataSUS MCP Server exposes 8 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 8 OpenDataSUS tools available for OpenAI Agents SDK
When OpenAI Agents SDK connects to OpenDataSUS through Vinkius, your AI agent gets direct access to every tool listed below — spanning public-health, brazil-health, dataset-discovery, 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.
Datastore search on OpenDataSUS
Search and filter data within a resource
Group list on OpenDataSUS
List all groups (categories)
Organization list on OpenDataSUS
List all organizations (data providers)
Package list on OpenDataSUS
List all dataset names in the OpenDataSUS portal
Package search on OpenDataSUS
Search for datasets matching specific criteria
Package show on OpenDataSUS
Get full metadata of a specific dataset
Resource show on OpenDataSUS
Get metadata for a specific resource
Tag list on OpenDataSUS
List all tags used across datasets
Connect OpenDataSUS to OpenAI Agents SDK via MCP
Follow these steps to wire OpenDataSUS into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the OpenDataSUS MCP Server
OpenAI Agents SDK provides unique advantages when paired with OpenDataSUS through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
OpenDataSUS + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the OpenDataSUS MCP Server delivers measurable value.
Automated workflows: build agents that query OpenDataSUS, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries OpenDataSUS, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through OpenDataSUS tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query OpenDataSUS to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for OpenDataSUS in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with OpenDataSUS immediately.
"Search for datasets related to 'vacinacao covid' in OpenDataSUS."
"List all health organizations providing data on the portal."
"Query the first 5 rows of the resource with ID 'd3848184-5077-4667-835d-591d67641bb9'."
Troubleshooting OpenDataSUS MCP Server with OpenAI Agents SDK
Common issues when connecting OpenDataSUS to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
OpenDataSUS + OpenAI Agents SDK FAQ
Common questions about integrating OpenDataSUS MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Explore More MCP Servers
View all →
OpenCost (K8s Cost)
6 toolsMonitor and analyze Kubernetes infrastructure costs — query workload allocations, backing assets, and cloud billing directly from your AI agent.
N26 Banking
3 toolsUniversal N26 intelligence — check balances, accounts, and spaces via AI.
PagerDuty Incident Trigger
1 toolsThis MCP does exactly one thing: it triggers incidents in PagerDuty. That's its only function, and nothing else. Incredible for giving your AI agents the power to wake up engineers.
Withings
10 toolsAccess comprehensive health and fitness data — track weight, blood pressure, sleep cycles, steps, workouts, and heart rate directly from Withings devices.