How to Use the Junta de Andalucía (Portal) MCP in Pydantic AI

Build type-safe integrations with Andalusian public records using Pydantic AI validation guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Junta de Andalucía (Portal) MCP to Pydantic AI

Create your Vinkius account to connect Junta de Andalucía (Portal) to Pydantic AI 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 Junta de Andalucía (Portal) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate Andalusian metadata with Pydantic AI

`get_package` fetches the full metadata schema of any dataset on the Andalusian portal. Pydantic AI parses this JSON payload against strict runtime models, ensuring your agent never processes corrupt or modified government schemas. If the portal updates its database structure, `get_resource` catches the change immediately. Your python application will fail loudly with a validation error instead of passing bad data to downstream models.

Query portal databases using this MCP Server

`search_datastore` executes queries against the Andalusian portal's live databases. Your Pydantic AI agent uses this tool to pull specific records, casting the raw API response into strongly-typed Python objects. This prevents silent parsing failures when dealing with municipal financial records or demographic data. The agent knows exactly what fields to expect before the data hits your application logic.

Discover regional datasets programmatically

`list_packages` retrieves the index of all available datasets published by the regional government. Pydantic AI processes this list to find new data sources that match your target schemas. The agent maps these packages to their owners using `list_organizations` and categories using `list_groups`. This builds a validated, type-safe directory of Andalusian public resources at runtime using this MCP connection.

Setup guide

Set up Junta de Andalucía (Portal) MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "junta-de-andalucia-portal-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Junta de Andalucía (Portal) tools.",
)

result = await agent.run("List recent Junta de Andalucía (Portal) transactions")
print(result.output)

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 Junta de Andalucía. 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 Junta de Andalucía (Portal) 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 Junta de Andalucía (Portal) MCP in Pydantic AI

Pass the Vinkius server URL to MCPToolset and register it in your Agent constructor. The Pydantic AI agent will instantly discover tools like `list_packages` and `get_package` with full runtime type validation.

Pydantic AI will raise a validation error immediately. This prevents your agent from hallucinating properties or processing malformed Andalusian public records.

Yes. The MCP integration supports asynchronous execution. Your Pydantic AI agent can run parallel tasks like `search_datastore` and `get_resource` without blocking your main application loop.

No. Vinkius hosts the server in a secure sandbox. You only need to pass the hosted streamable HTTP endpoint to your python codebase.

The server only accesses publicly available government datasets and resources. All validation occurs in your local Pydantic AI environment, meaning no private variables or keys are ever sent to the public portal.

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