Relevance AI MCP Server for Claude Code 10 tools — connect in under 2 minutes
Claude Code is Anthropic's agentic CLI for terminal-first development. Add Relevance AI as an MCP server in one command and Claude Code will discover every tool at runtime. ideal for automation pipelines, CI/CD integration, and headless workflows via Vinkius.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install Relevance AI and 2,500+ MCP Servers from a single visual interface.
# Your Vinkius token. get it at cloud.vinkius.com
claude mcp add relevance-ai --transport http "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
* 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.
Claude Code registers Relevance AI as an MCP server in a single terminal command. Once connected, Claude Code discovers all 10 tools at runtime and can call them headlessly. ideal for CI/CD pipelines, cron jobs, and automated workflows where Relevance AI data drives decisions without human intervention.
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 Claude Code 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 Claude Code via MCP
Follow these steps to integrate the Relevance AI MCP Server with Claude Code.
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
Add the MCP Server
Run the command above in your terminal
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
Start using Relevance AI
Ask Claude: "Using Relevance AI, show me...". 10 tools are ready
Why Use Claude Code with the Relevance AI MCP Server
Claude Code provides unique advantages when paired with Relevance AI through the Model Context Protocol.
Single-command setup: `claude mcp add` registers the server instantly. no config files to edit or applications to restart
Terminal-native workflow means MCP tools integrate seamlessly into shell scripts, CI/CD pipelines, and automated DevOps tasks
Claude Code runs headlessly, enabling unattended batch processing using Relevance AI tools in cron jobs or deployment scripts
Built by the same team that created the MCP protocol, ensuring first-class compatibility and the fastest adoption of new protocol features
Relevance AI + Claude Code Use Cases
Practical scenarios where Claude Code combined with the Relevance AI MCP Server delivers measurable value.
CI/CD integration: embed Relevance AI tool calls in your deployment pipeline to validate configurations or fetch secrets before shipping
Headless batch processing: schedule Claude Code to query Relevance AI nightly and generate reports without human intervention
Shell scripting: pipe Relevance AI outputs into other CLI tools for data transformation, filtering, and aggregation
Infrastructure monitoring: run Claude Code in a cron job to query Relevance AI status endpoints and alert on anomalies
Relevance AI MCP Tools for Claude Code (10)
These 10 tools become available when you connect Relevance AI to Claude Code 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 Claude Code
Ready-to-use prompts you can give your Claude Code 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 Claude Code
Common issues when connecting Relevance AI to Claude Code through the Vinkius, and how to resolve them.
Command not found: claude
npm install -g @anthropic-ai/claude-codeConnection timeout
Relevance AI + Claude Code FAQ
Common questions about integrating Relevance AI MCP Server with Claude Code.
How do I add an MCP server to Claude Code?
claude mcp add --transport http "" in your terminal. Claude Code registers the server and discovers all tools immediately.Can Claude Code run MCP tools in headless mode?
How do I list all connected MCP servers?
claude mcp in your terminal to see all registered servers and their status, or type /mcp inside an active Claude Code session.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 Claude Code
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.