How to Use the Dades Obertes Catalunya MCP in OpenAI Agents SDK

Query Catalonia's open data directly in your OpenAI Agents SDK production pipeline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Dades Obertes Catalunya MCP to OpenAI Agents SDK

Create your Vinkius account to connect Dades Obertes Catalunya 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 Dades Obertes Catalunya with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Find datasets with OpenAI Agents SDK

Your agent identifies specific data sources by calling `search_catalog`. It scans the official portal records to match your request to the correct dataset ID. This keeps your agent focused on finding relevant public information without manual browsing. It maps human requests to precise system identifiers.

Run SoQL queries in your agent

The `query_dataset` tool allows your agent to pull raw records using standard SoQL parameters. You define the filters and limits inside your agent loop. This retrieves filtered data directly into your Python environment. Your agent processes these results to answer questions about regional trends.

Production-ready data integration

This MCP Server plugs into your agent setup using the `MCPServerStreamableHttp` class. It respects your agent's cache settings to keep response times fast. You get reliable data flow without writing custom scrapers. Your agent handles the transport while you focus on the logic.

Setup guide

Set up Dades Obertes Catalunya 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 Dades Obertes Catalunya tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Dades Obertes Catalunya 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="Dades Obertes Catalunya Agent",
            instructions="You have access to Dades Obertes Catalunya 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 Dades Obertes Catalunya. 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.