How to Use the Copilot CRM (Assembly) MCP in Mastra AI

Q: Can I build a Mastra AI workflow that automatically triggers on new Copilot CRM (Assembly) invoices?

Yes, you can set up a cron-based agent that queries listinvoices at set intervals. The workflow can then loop through unpaid bills and use Mastra's built-in step retries if the portal API experiences temporary downtime.

Q: How do I handle human-in-the-loop approvals for Copilot CRM (Assembly) updates in Mastra AI?

You configure requireToolApproval on the Mastra client instance. When the agent decides to run updateclient or createclient, the workflow pauses until an admin approves the action.

Q: Does this Copilot CRM (Assembly) MCP Server support Mastra AI's automatic retry mechanism?

Yes, all tool executions like getclientdetails are fully compatible with Mastra's retry logic. If a network blip occurs while retrieving client records, the system will back off and try again automatically.

Q: How do I map custom fields inside a Mastra agent?

You should query listcustomfields during the initialization step of your workflow. This allows your Mastra agent to dynamically map incoming payloads to the correct portal schema.

Q: What happens to my portal message data when processed by this MCP Server?

Message threads fetched via listportalmessages are processed entirely in memory within Vinkius's ephemeral sandbox. No message content or contact info is permanently cached on the proxy server.

Build resilient Mastra AI workflows that automatically update and sync your Copilot CRM (Assembly) records.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Copilot CRM (Assembly) MCP to Mastra AI

Create your Vinkius account to connect Copilot CRM (Assembly) 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 Copilot CRM (Assembly) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated multi-step onboarding workflows

The `create_client` tool acts as the entry point for your Mastra AI agent workflows. You can build a system that automatically catches new signups, registers them, and immediately triggers a conditional branch to check their details. If the registration succeeds, the workflow can run `update_client` to assign account managers or link company records. If a step fails, Mastra's engine automatically retries the operation with exponential backoff.

Resilient billing sync via Mastra AI workflows

This MCP Server connects `list_invoices` to your automated agent loops for hands-off payment tracking. Mastra AI can periodically pull invoice lists, identify overdue accounts, and trigger follow-up actions without manual intervention. You can configure the workflow to retrieve company details using `list_companies` if a bill remains unpaid. This lets your backend agents handle complex escalation paths safely.

Smart form submission routing

We use the `list_forms` and `list_portal_messages` tools to let your agent monitor and process incoming client communications. When a user submits a form, Mastra AI parses the payload and matches it against existing records. If no match exists, the workflow can query `list_clients` to verify before generating a new entry. You have full control over this process, including the ability to require human approval before any record is modified.

Setup guide

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

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

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

Yes, you can set up a cron-based agent that queries `list_invoices` at set intervals. The workflow can then loop through unpaid bills and use Mastra's built-in step retries if the portal API experiences temporary downtime.

You configure `requireToolApproval` on the Mastra client instance. When the agent decides to run `update_client` or `create_client`, the workflow pauses until an admin approves the action.

Yes, all tool executions like `get_client_details` are fully compatible with Mastra's retry logic. If a network blip occurs while retrieving client records, the system will back off and try again automatically.

You should query `list_custom_fields` during the initialization step of your workflow. This allows your Mastra agent to dynamically map incoming payloads to the correct portal schema.

Message threads fetched via `list_portal_messages` are processed entirely in memory within Vinkius's ephemeral sandbox. No message content or contact info is permanently cached on the proxy server.

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