How to Use the Affinity MCP in Mastra AI

Q: How do I register the Affinity MCP tools within Mastra AI?

Instantiate the client using new MCPClient with your Vinkius URL. Call listTools() and spread them directly into your agent's tool configuration array.

Q: Can Mastra AI handle human-in-the-loop approvals for Affinity updates?

Yes. You can configure requireToolApproval on tools like listlistentries to ensure a human reviews the list of organizations before any automated workflow proceeds.

Q: How does Mastra AI manage errors when calling Affinity tools?

Mastra features automatic exponential backoff retries. If listinteractions hits a rate limit or network hiccup, the framework pauses and retries the request automatically.

Build resilient, automated CRM workflows with Mastra AI and the Affinity 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 Affinity MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate pipeline monitoring in Mastra AI

The `list_smart_lists` tool exposes your custom pipelines so your Mastra agents can monitor deal progress. The agent triggers workflows when deals stall or shift stages. If a network call fails, Mastra's built-in retry engine backs off and tries again automatically. This ensures your pipeline checks run reliably without manual intervention.

Run conditional branching on contact data

The `list_persons` tool retrieves paginated lists of people your team has contacted. Mastra routes these contacts through conditional logic blocks based on their interaction history. For example, if a contact has no recent emails, Mastra branches the workflow to trigger a follow-up task. You write the logic in TypeScript and let the agent handle the sorting.

Sync company profiles with this MCP Server

The `list_organizations` tool retrieves institutional records mapped within your CRM. Your Mastra workflows use this tool to verify company details before executing multi-step updates. You deploy these workflows to your cloud provider with a single command. The agent keeps your organizational database clean by running scheduled checks against your main database.

Setup guide

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

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

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

Instantiate the client using `new MCPClient` with your Vinkius URL. Call `listTools()` and spread them directly into your agent's tool configuration array.

Yes. You can configure `requireToolApproval` on tools like `list_list_entries` to ensure a human reviews the list of organizations before any automated workflow proceeds.

Mastra features automatic exponential backoff retries. If `list_interactions` hits a rate limit or network hiccup, the framework pauses and retries the request automatically.

Yes. Mastra automatically detects the transport type, allowing you to establish stable SSE or Streamable HTTP connections to the MCP server hosted on Vinkius.

Your interaction logs and contact records are processed in zero-trust, ephemeral V8 isolates. No CRM data persists on the Vinkius platform after your Mastra workflow execution finishes.

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