Compatible with every major AI agent and IDE
What is the Dades Obertes Catalunya MCP Server?
Unlock the power of Dades Obertes Catalunya, the official open data platform of the Government of Catalonia. This MCP server allows your AI agent to browse thousands of public datasets and perform complex queries through natural conversation.
What you can do
- Catalog Discovery — Search for datasets by keywords, categories, or tags to find relevant public information using the
search_catalogtool. - Advanced Querying — Use SoQL (Socrata Query Language) via
query_datasetto filter, select specific columns, and sort data from any dataset using its 4x4 identifier. - Data Analysis — Group results and perform full-text searches across entire datasets to extract insights on health, transport, economy, and more.
- Pagination & Limits — Efficiently handle large datasets with built-in support for limits and offsets to browse records systematically.
How it works
- Subscribe to this server
- (Optional) Enter your Socrata App Token for higher rate limits
- Start querying Catalan public data from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Data Analysts — quickly pull public statistics into your workflow without manual CSV downloads
- Researchers — find and cross-reference government data on demographics, environment, or urban planning
- Developers — test data queries and explore API structures directly through natural language
Built-in capabilities (2)
g., abcd-1234). Supports SoQL parameters like $select, $where, $limit. Query a specific dataset using SoQL parameters
Returns dataset identifiers needed for the query_dataset tool. Search the Dades Obertes Catalunya catalog for datasets
Why OpenAI Agents SDK?
The OpenAI Agents SDK auto-discovers all 2 tools from Dades Obertes Catalunya through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Dades Obertes Catalunya, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
- —
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
Dades Obertes Catalunya in OpenAI Agents SDK
Dades Obertes Catalunya and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Dades Obertes Catalunya to OpenAI Agents SDK through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for Dades Obertes Catalunya in OpenAI Agents SDK
The Dades Obertes Catalunya 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. All 2 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in OpenAI Agents SDK only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.

* 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
How Vinkius secures
Dades Obertes Catalunya for OpenAI Agents SDK
Every tool call from OpenAI Agents SDK to the Dades Obertes Catalunya MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
How do I find the unique identifier for a specific dataset?
Use the search_catalog tool with a descriptive query. The response will include the 4x4 alphanumeric ID (e.g., 'abcd-1234') which you can then use with the query_dataset tool.
Can I filter data by specific values like a city or a date range?
Yes! When using query_dataset, use the $where parameter to apply SoQL filters. For example, $where: "poblacio > 5000" or $where: "comarca = 'Barcelonès'".
Is a Socrata App Token mandatory to use this server?
No, it is optional. However, providing a DADES_APP_TOKEN allows for higher rate limits and prevents throttling during intensive data exploration.
How does the OpenAI Agents SDK connect to MCP?
Use 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?
Yes. Pass a list of 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?
Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.
MCPServerStreamableHttp not found
Ensure you have the latest version: pip install --upgrade openai-agents
Agent not calling tools
Make sure your prompt explicitly references the task the tools can help with.
Explore More MCP Servers
View all →
fal.ai 3D
12 toolsGenerate 3D models via fal.ai — convert images and text to 3D assets using Rodin, TripoSR, Trellis, and 9+ AI models from any AI agent.

AntChain
10 toolsAlibaba's enterprise blockchain API hub — query blocks, transactions, smart contracts, and accounts on AntChain BaaS.

JotForm
10 toolsManage forms, submissions, and reports via JotForm API.

100ms
9 toolsManage video rooms, active sessions, and participants on 100ms — the powerful live video infrastructure.
