Relevance AI MCP Server for Mastra AI 10 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Relevance AI 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
Vinkius supports streamable HTTP and SSE.
import { 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: {
"relevance-ai": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Relevance AI Agent",
instructions:
"You help users interact with Relevance AI " +
"using 10 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Relevance AI?"
);
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 Relevance AI MCP Server
Connect your conversational AI to your Relevance AI workspace. By wrapping your custom agents, datasets, and API tools into this MCP extension, you transform your chat interface into a command center for orchestrating complex, autonomous AI operations and large-scale data workflows.
Mastra's agent abstraction provides a clean separation between LLM logic and Relevance AI tool infrastructure. Connect 10 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
- Orchestrate Agents — Command your pre-built autonomous agents to execute tasks (
trigger_agent). Monitor their progress and read their exact reasoning steps dynamically (get_agent_run). Uselist_agentsto discover all available AI worker configurations. - Execute Tasks & Workflows — Trigger predefined chained prompts or specific micro-tasks without leaving your chat (
trigger_task), scaling repetitive workflows reliably. - Manage Knowledge Datasets — Take full control of your vector databases and tables. Insert new rows of knowledge directly from conversational context (
insert_documents), retrieve raw unstructured data entries (get_documents), or surgically delete obsolete knowledge base items (delete_documents).
The Relevance AI MCP Server exposes 10 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Relevance AI to Mastra AI via MCP
Follow these steps to integrate the Relevance AI MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 10 tools from Relevance AI via MCP
Why Use Mastra AI with the Relevance AI MCP Server
Mastra AI provides unique advantages when paired with Relevance AI through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Relevance AI 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 Relevance AI 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
Relevance AI + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Relevance AI MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Relevance AI, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Relevance AI as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Relevance AI on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Relevance AI tools alongside other MCP servers
Relevance AI MCP Tools for Mastra AI (10)
These 10 tools become available when you connect Relevance AI to Mastra AI via MCP:
delete_documents
This action is irreversible. Deletes documents from a dataset by their IDs
get_agent_run
Retrieves the status and logs of a specific agent run
get_documents
Retrieves documents from a dataset
insert_documents
Provide documents as a JSON array of objects. Inserts documents into a dataset
list_agents
Lists all AI agents in the Relevance AI studio
list_datasets
Lists all datasets (knowledge tables) in the project
list_tasks
Lists all tasks (chained prompts) in the studio
list_tools
Lists all custom tools registered in the studio
trigger_agent
Provide inputs as a JSON object. Triggers an AI agent execution
trigger_task
Triggers a specific task execution
Example Prompts for Relevance AI in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Relevance AI immediately.
"List all available agents in my Relevance AI Studio and their IDs."
"Start a run for the 'Market Analysis' agent passing `{"company": "OpenAI"}` as the payload, then tell me the Run ID."
"Insert this JSON array of top competitor articles into the 'competitor_docs' dataset."
Troubleshooting Relevance AI MCP Server with Mastra AI
Common issues when connecting Relevance AI to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpRelevance AI + Mastra AI FAQ
Common questions about integrating Relevance AI 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?
Connect Relevance AI with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Relevance AI to Mastra AI
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.