Gipuzkoa Irekia MCP Server for Mastra AIGive Mastra AI instant access to 9 tools to List Groups, List Organizations, List Packages, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Gipuzkoa Irekia through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Gipuzkoa Irekia MCP Server for Mastra AI is a standout in the Knowledge Management category — giving your AI agent 9 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"gipuzkoa-irekia": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Gipuzkoa Irekia Agent",
instructions:
"You help users interact with Gipuzkoa Irekia " +
"using 9 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Gipuzkoa Irekia?"
);
console.log(result.text);
}
main();
* 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
About Gipuzkoa Irekia MCP Server
Connect to the Gipuzkoa Irekia open data portal and empower your AI agent to explore public sector information from the Gipuzkoa region through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Gipuzkoa Irekia tool infrastructure. Connect 9 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Dataset Discovery — Search for specific datasets (packages) using keywords or filter by organization and metadata
- Resource Inspection — Access detailed metadata for specific data files (resources), including formats and download links
- Organizational Browsing — List and inspect the various public departments and municipalities that publish data
- Thematic Exploration — Navigate data through thematic groups such as transport, environment, or economy
- Advanced Querying — Perform Solr-like searches to find precise information within the vast public catalog
The Gipuzkoa Irekia MCP Server exposes 9 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 9 Gipuzkoa Irekia tools available for Mastra AI
When Mastra AI connects to Gipuzkoa Irekia through Vinkius, your AI agent gets direct access to every tool listed below — spanning open-data, public-sector, dataset-discovery, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
List groups on Gipuzkoa Irekia
List all group names
List organizations on Gipuzkoa Irekia
List all organization names
List packages on Gipuzkoa Irekia
List all dataset (package) names
Search packages on Gipuzkoa Irekia
Search for datasets
Search resources on Gipuzkoa Irekia
Search for resources
Show group on Gipuzkoa Irekia
Get details for a specific group
Show organization on Gipuzkoa Irekia
Get details for a specific organization
Show package on Gipuzkoa Irekia
Get metadata for a specific dataset
Show resource on Gipuzkoa Irekia
Get metadata for a specific resource
Connect Gipuzkoa Irekia to Mastra AI via MCP
Follow these steps to wire Gipuzkoa Irekia into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Gipuzkoa Irekia MCP Server
Mastra AI provides unique advantages when paired with Gipuzkoa Irekia through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Gipuzkoa Irekia without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Gipuzkoa Irekia tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Gipuzkoa Irekia + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Gipuzkoa Irekia MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Gipuzkoa Irekia, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Gipuzkoa Irekia as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Gipuzkoa Irekia on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Gipuzkoa Irekia tools alongside other MCP servers
Example Prompts for Gipuzkoa Irekia in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Gipuzkoa Irekia immediately.
"List all the organizations that publish open data in Gipuzkoa."
"Search for datasets related to 'environment' in the Gipuzkoa Irekia catalog."
"Show me the metadata for the dataset named 'presupuestos-municipales'."
Troubleshooting Gipuzkoa Irekia MCP Server with Mastra AI
Common issues when connecting Gipuzkoa Irekia to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpGipuzkoa Irekia + Mastra AI FAQ
Common questions about integrating Gipuzkoa Irekia MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Supabase
10 toolsConnect your AI to Supabase. Execute database queries, manage users, and trigger PostgreSQL functions directly from your terminal.
TikTok Full Ads
17 toolsComplete TikTok Ads management � create campaigns, control budgets, analyze performance, track conversions, and manage creative assets via AI.
Tactile CRM
9 toolsConnect your AI to Tactile CRM. Query companies, read contact details, and evaluate your sales opportunities and pipelines natively from the terminal.
EasySendy
11 toolsSend high-volume email campaigns through multiple delivery servers with list hygiene tools that protect your sender score.