How to Use the Capsule CRM MCP in Mastra AI

Build resilient, self-healing sales workflows with Mastra AI and the Capsule CRM integration.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Capsule CRM MCP to Mastra AI

Create your Vinkius account to connect Capsule CRM 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 Capsule CRM with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-retrying Capsule CRM task creation

The `create_task` tool registers new follow-ups in Capsule CRM within automated agent workflows. Mastra AI wraps this tool in its workflow engine, meaning if the API rate limit hits, the agent automatically retries with exponential backoff. This setup prevents lost leads and broken sales pipelines. You do not have to write manual retry loops or error handling code to keep your sales records clean and up to date.

Multi-step sales qualification pipelines

The `get_opportunity_details` tool extracts sales deal data to fuel conditional branching logic in your agents. Your Mastra AI agent can check a deal's value, decide if it meets your enterprise threshold, and automatically trigger high-priority alerts. You initialize the client using the MCP Server connection and spread the tools directly into your agent definition. The framework handles the transport layer automatically so you can focus on building the branching logic.

Human-in-the-loop approvals for Capsule CRM MCP Server

The `create_person` tool writes new contact profiles directly into your CRM database. Because you do not want your agent creating duplicate records unchecked, you can use Mastra's tool approval feature to require manual sign-off first. When the agent decides to add a contact, the workflow pauses and waits for a manager's confirmation. Once approved, this MCP Server executes the action and updates the workspace immediately.

Setup guide

Set up Capsule CRM 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 Capsule CRM 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: "capsule-crm-mcp-client",
  servers: {
    "capsule-crm-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Capsule CRM Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Capsule CRM tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Capsule CRM 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 Capsule CRM. 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 Capsule CRM 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 Capsule CRM MCP in Mastra AI

You instantiate the Mastra client with the server URL and call listTools. Then, simply spread those tools into your agent's tool array during initialization.

Yes. Mastra's workflow engine features built-in exponential backoff. If the Capsule CRM API returns a rate limit error, the agent pauses and retries the tool call automatically.

You set the requireToolApproval flag to true on sensitive tools like contact creation. The agent will pause its workflow and wait for human confirmation before writing any data to your CRM.

This setup supports both Streamable HTTP and SSE transports. Mastra auto-detects the transport type, so you only need to provide the Vinkius connection URL.

Your sales pipeline, opportunities, and tasks are processed inside secure, ephemeral V8 isolates. No MCP data is stored on disk, and connection tokens are kept strictly in memory to prevent credential 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