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

Q: How do I query the Junta de Andalucía (Portal) using the Vercel AI SDK?

Install the @ai-sdk/mcp package and connect to the MCP Server endpoint using createMCPClient. Pass the tools returned by the client directly into streamText to let your agent call listpackages or searchdatastore during a live chat session.

Q: Can I browse regional publishers in the Junta de Andalucía (Portal) using the Vercel AI SDK?

Yes. The listorganizations tool gives your agent a clean list of all publishing bodies in the region. Your frontend can display these organizations in real-time as the agent discovers them.

Q: How does the MCP Server handle large dataset files?

The server uses getresource to fetch file metadata instead of downloading the entire file to your server. This keeps your edge functions light and prevents timeout issues on Vercel.

Q: Can my users filter datasets by category?

Use listgroups to fetch the high-level categories defined by the Andalusian government. Your agent uses this list to narrow down search queries before pulling specific packages.

Feed real-time Andalusian public datasets directly into your React components with the Vercel AI SDK and this dedicated 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 Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream dataset metadata straight to React

The `get_package` tool fetches metadata for a specific dataset from the Andalusian public records portal. Your web app calls this through the Vercel AI SDK, letting you pipe raw JSON schemas and resource lists directly into your frontend components without waiting for a full page reload. You avoid writing custom API wrappers for the regional government's portal. Instead, your agent grabs the exact package structure, formats it on the fly, and streams the UI components to the user.

Pull file-level resources on the edge

The `get_resource` tool retrieves the specific file metadata and download URLs for any dataset inside the portal. Running this on Vercel Edge Functions means your client gets instant access to CSV or PDF locations without cold boots slowing down the user experience. Once the URL is in hand, your interface can immediately render download buttons or trigger background parsers. No intermediate database queries are required to find where the government hosts the raw files.

Query datastores with this MCP Server

The `search_datastore` tool queries raw tabular data stored inside the portal's active resources. This MCP Server lets your application execute precise SQL-like searches against Andalusian public databases and stream the raw rows directly into a UI table. Your users see the data populating line-by-line as the LLM processes the query. It cuts out the typical wait times associated with downloading massive regional spreadsheets just to read a few rows.

Setup guide

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

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Junta de Andalucía (Portal) tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Junta de Andalucía (Portal) transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Install the `@ai-sdk/mcp` package and connect to the MCP Server endpoint using `createMCPClient`. Pass the tools returned by the client directly into `streamText` to let your agent call `list_packages` or `search_datastore` during a live chat session.

Yes. The `list_organizations` tool gives your agent a clean list of all publishing bodies in the region. Your frontend can display these organizations in real-time as the agent discovers them.

The server uses `get_resource` to fetch file metadata instead of downloading the entire file to your server. This keeps your edge functions light and prevents timeout issues on Vercel.

Use `list_groups` to fetch the high-level categories defined by the Andalusian government. Your agent uses this list to narrow down search queries before pulling specific packages.

This server only handles public governmental metadata and open-access datastore records. No personal user data or private credentials ever pass through the Vercel Isolate Sandbox, keeping your application isolated from data leaks.

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