The Model Context Protocol (MCP) is an open standard created by Anthropic that lets AI agents discover and use tools from external services. The PerfexCRM MCP server exposes all 170 CRM operations as tools that any MCP-compatible AI client can discover and execute through natural language.
Before MCP, connecting AI to your CRM meant building custom API wrappers and sub-workflows for every operation. Now it is one endpoint, one API key, and the AI figures out the rest.
{
"mcpServers": {
"perfexcrm": {
"url": "https://your-crm.com/api/v1/mcp",
"headers": {
"X-API-KEY": "pk_your_api_key"
}
}
}
}Three steps. Under 3 minutes. No SDKs, no custom code, no API wrappers. The AI discovers your CRM operations automatically through the MCP specification.
Go to Setup > API & Webhooks > Settings > Advanced and toggle MCP Server on. Takes 5 seconds.
Add the MCP endpoint to your AI client config. One URL + one API key.
The AI automatically discovers all 170 tools. Ask it anything about your CRM in natural language.
One endpoint, infinite possibilities. Any tool that speaks the Model Context Protocol can manage your CRM. For messaging apps (WhatsApp, Telegram, Slack), see OpenClaw and Hermes Agent.
Anthropic
OpenAI
IDE
Workflow
Continue / Cline
IDE
AWS
170 tools
Not just read data — your AI can create, update, delete, and manage everything across all 19 CRM resources and 170 operations. Including the full task lifecycle: create tasks, assign to staff, add checklists, update status, and log timesheets — all through natural language. See the full API reference for all available operations.
AI creates leads, converts to customers, and manages your entire sales pipeline through conversation. Ask: "Show me leads from this week and convert the top one to a customer."
AI triages tickets, assigns to teams, adds replies, and escalates high-priority issues. Ask: "Reply to ticket #512 with this message and assign it to the billing team."
AI creates invoices with line items, tracks overdue payments, records receipts, and generates summaries. Ask: "Create an invoice for Acme Corp: Web Development $2,500, Hosting $500."
AI creates tasks, assigns to staff, tracks milestones, and reports project progress. Ask: "Create a task for Sarah to review the proposal by Friday, high priority."
A real example: creating an invoice through Claude + MCP
Create an invoice for Acme Corp with 2 items: "Web Development" for $2,500 and "Hosting Setup" for $500
I'll create that invoice for you. Let me look up Acme Corp first...
Done! Invoice #INV-00847 created for Acme Corp:
Now send it to their email
Sent! Invoice #INV-00847 has been emailed to billing@acmecorp.com.
All four connect to the same PerfexCRM data. Pick based on your use case — or use multiple simultaneously. Every option is included in the same $49 PerfexAPI module.
| Feature | MCP Server | REST API | OpenClaw | Hermes Agent |
|---|---|---|---|---|
| Best for | AI coding tools | Custom integrations | 20+ messaging apps | Self-improving AI + cron |
| Interface | Natural language | HTTP requests | WhatsApp/Telegram/Slack | WhatsApp/Telegram/Signal |
| Setup time | ~1 minute | Varies (code) | ~10 minutes | ~10 minutes |
| Code required | Zero (config only) | Yes (any language) | Zero | Zero |
| Tool discovery | Automatic | Manual (read docs) | Via CRM skill | Via MCP |
| AI clients | Claude, ChatGPT, Cursor, 50+ | Any HTTP client | 20+ messaging platforms | 7+ channels + CLI |
| Windows native | Yes | Yes | Yes | WSL2 required |
| Built-in cron | No | No | No | Yes |
| Cost | Included ($0 extra) | Included ($0 extra) | Free (MIT) | Free (MIT) |
Enterprise-grade implementation of the Model Context Protocol specification
Standard HTTP transport with SSE support. Works through firewalls, proxies, and load balancers. JSONRPC 2.0 endpoint at /api/v1/mcp.
AI agents only discover tools the API key is authorized for. Non-admin keys are filtered by staff-level CRM permissions. Full audit logging.
Every tool includes parameter descriptions, types, required/optional flags, and examples. AI agents know exactly how to use each operation.
MCP (Model Context Protocol) is an open standard created by Anthropic that lets AI agents discover and use tools from external services through a single endpoint. The PerfexCRM MCP server, built into the PerfexAPI module (v2.8.0+), exposes all 170 CRM operations as discoverable tools. When you connect any MCP-compatible AI client (Claude Desktop, ChatGPT, Cursor, n8n AI Agent, VS Code, and 50+ more), the AI automatically discovers available operations — create customers, issue invoices, manage leads, triage tickets, track projects — and executes them through natural language conversation. No custom code or API wrappers needed.
Any AI client that implements the Model Context Protocol specification is compatible. Confirmed clients include Claude Desktop (Anthropic), ChatGPT (OpenAI with MCP support), Cursor IDE, VS Code (via Continue or Cline extensions), Windsurf IDE, Amazon Q (AWS), n8n AI Agent node, and 50+ more. Additionally, open-source AI agent frameworks like Hermes Agent (by Nous Research) and OpenClaw connect through the same MCP endpoint to provide WhatsApp, Telegram, and Slack CRM access.
Setup takes under 3 minutes with zero coding. Step 1: Go to your PerfexCRM admin panel, navigate to Setup > API & Webhooks > Settings > Advanced, and toggle MCP Server to enabled. Step 2: Copy your MCP endpoint URL (https://your-crm.com/api/v1/mcp) and an API key. Step 3: Add these to your AI client config file. For Claude Desktop, edit claude_desktop_config.json and add a perfexcrm entry under mcpServers with your URL and X-API-KEY header. The AI discovers all 170 tools automatically on first connection.
Yes. As of v2.8.7, the PerfexCRM MCP server loads all 170 tools in a single response, which resolves a known Claude.ai pagination limitation where only the first 50 tools were visible. Claude.ai users can now connect the MCP endpoint directly as a custom connector and access all CRM operations including the full task management suite (22 task tools). This fix also benefits Claude Desktop, Claude Code, and Kiro.
Yes. The MCP server exposes 22 task-related tools covering the full lifecycle: tasks_create, tasks_get, tasks_update, tasks_delete, tasks_assign, tasks_status_update, tasks_mark_complete, tasks_priority_update, tasks_checklist_create/update/delete, tasks_followers_add/remove, tasks_comments_create, and tasks_timesheets_create. Ask your AI: "Create a task for Sarah to review the proposal by Friday, high priority, and add a checklist with 3 items." The AI calls the right tools automatically.
Yes. The MCP server enforces the same permission model as the REST API. Each API key has configurable permissions — when an AI agent connects, it only discovers and can execute operations that the API key is authorized for. Non-admin keys are filtered by PerfexCRM staff-level permissions, so a support team key can view and reply to tickets but cannot access billing data. All MCP operations are logged in the admin panel under API Logs for full audit trail visibility.
Yes. The MCP server is included in every PerfexAPI plan at no extra cost — Launch Special ($49), Professional ($89), and Extended ($449). All plans get access to all 170 CRM tools via MCP. There are no per-request fees, no token limits on the MCP side, and no separate subscription for AI features. The only variable cost is your AI model usage (Claude, GPT-4, etc.) which is billed directly by the model provider.
All three connect to the same PerfexCRM endpoints but serve different use cases. MCP Server is built into the module and connects AI coding tools (Claude Desktop, ChatGPT, Cursor) — zero setup, ideal for developers. OpenClaw (313K+ GitHub stars) connects PerfexCRM to 20+ messaging platforms (WhatsApp, Telegram, Slack, Teams) for teams wanting mobile-first CRM access. Hermes Agent (87K+ stars, by Nous Research) adds self-improving memory and a cron scheduler for automated daily briefings. Use one, two, or all three simultaneously — they all work with the same $49 module.
Yes. n8n AI Agent node (v1.2+) supports MCP as a tool provider. Add the PerfexCRM MCP endpoint as an MCP Client Tool in your n8n workflow, and the AI Agent node automatically discovers all 170 CRM operations. This lets you build AI-powered automation workflows where the agent decides which CRM operations to execute based on natural language instructions or incoming data. See our n8n templates for ready-to-use examples.
Last updated: April 2026
Read the full announcement with detailed setup instructions, security model, and what comes next. Or try the Hermes Agent cron tutorial for scheduled CRM briefings.
Get the complete PerfexCRM API module — REST API, Webhooks, n8n Node, MCP Server, OpenClaw skill, and Hermes Agent support. All 170 tools. All plans.