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

Q: How do I hook up the Junta de Andalucía (Portal) to a Mastra AI workflow?

Instantiate the MCPClient in your Mastra setup and register the server URL. Spread the tools into your agent definition so it can call listpackages or getpackage whenever a workflow step requires official regional data.

Q: How do I get specific file URLs from the Junta de Andalucía (Portal) using Mastra AI?

The getresource tool returns the exact download links and file formats for a given dataset. Your agent can pass these URLs to subsequent steps in your pipeline for downloading or processing.

Q: Can I filter datasets by administrative groups?

Yes. The listgroups tool provides the thematic categories used by the portal. Your agent can query this list first to filter down the datasets it needs to process in your workflow.

Build automated workflows that fetch, filter, and alert on Andalusian public data using Mastra AI and this MCP Server.

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 Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate regional data discovery

The `list_packages` tool retrieves a complete list of dataset names published by the Andalusian government. Mastra AI agents use this tool to index the portal, feeding downstream workflow steps that monitor for new public records. You can set up cron-like agents that run daily, compare the package list against a local database, and trigger alerts when a new dataset appears. This bypasses manual checking of the government portal.

Parse structured tables with Mastra workflows

The `search_datastore` tool executes direct queries inside database-backed portal resources. Mastra AI workflows handle the heavy lifting by executing these queries, parsing the returned rows, and running conditional checks on the data. If a query returns values exceeding a specific threshold, your workflow branches automatically to notify your team. You get a reliable pipeline that acts on live government data with built-in retries.

Map publishers with this MCP Server

The `list_organizations` tool extracts the full list of departments and agencies publishing data to the portal. Your Mastra agents use this to map out which regional department owns which dataset, ensuring your automated reports route questions to the correct entity. This mapping happens entirely in memory during workflow execution. Your agent doesn't need to guess the publisher; it gets the exact organizational ID directly from the server.

Setup guide

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

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Junta de Andalucía (Portal) tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "junta-de-andalucia-portal-mcp-client",
  servers: {
    "junta-de-andalucia-portal-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Junta de Andalucía (Portal) Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Junta de Andalucía (Portal) tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Junta de Andalucía (Portal) transactions"
);
console.log(result.text);

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 Mastra AI

Instantiate the `MCPClient` in your Mastra setup and register the server URL. Spread the tools into your agent definition so it can call `list_packages` or `get_package` whenever a workflow step requires official regional data.

Yes, Mastra has a built-in workflow engine that manages retries and exponential backoff. If the portal's API rate-limits a `search_datastore` call, the engine pauses and retries the step automatically.

The `get_resource` tool returns the exact download links and file formats for a given dataset. Your agent can pass these URLs to subsequent steps in your pipeline for downloading or processing.

Yes. The `list_groups` tool provides the thematic categories used by the portal. Your agent can query this list first to filter down the datasets it needs to process in your workflow.

This integration only processes public Andalusian dataset metadata and open-source files. No private business logic or database records from your Mastra server are sent to the external portal API.

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