feat(crm): add FluentCRM MCP integration for sales and marketing

.agent/AGENTS.md

@@ -357,8 +357,8 @@ See `workflows/session-manager.md` for full session lifecycle guidance.
 | `seo.md` | SEO optimization and analysis |
 | `content.md` | Content creation workflows |
 | `research.md` | Research and analysis tasks |
-| `marketing.md` | Marketing strategy |
-| `sales.md` | Sales operations |
+| `marketing.md` | Marketing strategy, email campaigns, automation (FluentCRM) |
+| `sales.md` | Sales operations, CRM, pipeline management (FluentCRM) |
 | `legal.md` | Legal compliance |
 | `accounts.md` | Financial operations |
 | `health.md` | Health and wellness |
@@ -396,6 +396,7 @@ Subagents provide specialized capabilities. Read them when tasks require domain
 | `services/hosting/` | Hosting providers - DNS, domains, cloud servers, managed WordPress | hostinger, hetzner, cloudflare, cloudron, closte, 101domains, spaceship |
 | `services/email/` | Email services - transactional email, deliverability | ses |
 | `services/communications/` | Communications platform - SMS, voice, WhatsApp, verify, recordings | twilio, telfon |
+| `services/crm/` | CRM integration - contact management, email marketing, automation | fluentcrm |
 | `services/accounting/` | Accounting integration - invoicing, expenses, financial reports | quickfile |
 | `workflows/` | Development processes - branching, releases, PR reviews, quality gates | git-workflow, plans, release, version-bump, pr, preflight, postflight, ralph-loop, session-review |
 | `templates/` | Document templates - PRDs, task lists, planning documents | prd-template, tasks-template, plans-template, todo-template |
@@ -458,6 +459,7 @@ For AI-assisted setup guidance, see `aidevops/setup.md`.
 | WordPress work | `tools/wordpress/wp-dev.md`, `tools/wordpress/mainwp.md` |
 | SEO analysis | `seo/dataforseo.md`, `seo/google-search-console.md` |
 | Sitemap submission | `seo/gsc-sitemaps.md` |
+| CRM/email marketing | `services/crm/fluentcrm.md` |
 | MCP development | `tools/build-mcp/build-mcp.md`, `tools/build-mcp/server-patterns.md` |
 | Agent design | `tools/build-agent/build-agent.md`, `tools/build-agent/agent-review.md` |
 | Database migrations | `workflows/sql-migrations.md` |

.agent/aidevops/add-new-mcp-to-aidevops.md

@@ -42,9 +42,23 @@ tools:
 
 **MCP Tool Enablement Strategy**:
 
-- **Global**: Disabled (`"mcp-name_*": false` in tools section)
-- **Per-Agent**: Enabled only for agents that need it
-- **Rationale**: Context efficiency - each agent only loads needed MCPs
+- **Global Config**: Disabled (`"enabled": false` in opencode.json)
+- **Subagent Only**: Enable `mcp-name_*: true` in the subagent's `tools:` section
+- **Never in Main Agents**: Main agents (sales.md, marketing.md, etc.) reference subagents but never enable MCPs directly
+- **Rationale**: Context efficiency - MCP only loads when subagent is invoked
+
+**Correct Pattern**:
+
+```yaml
+# In services/crm/fluentcrm.md (SUBAGENT) - CORRECT
+tools:
+  fluentcrm_*: true  # MCP enabled here
+
+# In sales.md (MAIN AGENT) - references subagent, no MCP
+tools:
+  read: true
+  # NO fluentcrm_* here - main agents don't enable MCPs
+```
 
 **Related Agents to Call**:
 

.agent/aidevops/mcp-integrations.md

@@ -58,6 +58,10 @@ This document provides comprehensive setup and usage instructions for advanced M
 
 - **Next.js DevTools MCP**: Next.js development and debugging assistance
 
+### **📧 CRM & Marketing**
+
+- **FluentCRM MCP**: WordPress CRM with contacts, campaigns, automations, and email marketing
+
 ### **📚 Legacy MCP Servers (from MCP-SERVERS.md)**
 
 - **Context7 MCP**: Real-time documentation access for development libraries
@@ -130,6 +134,61 @@ export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"
 claude mcp add google-search-console npx mcp-server-gsc@latest
 ```
 
+### **FluentCRM MCP**
+
+**Note**: The FluentCRM MCP server is not published to npm. It requires cloning and building locally.
+
+```bash
+# 1. Clone and build the MCP server
+mkdir -p ~/.local/share/mcp-servers
+cd ~/.local/share/mcp-servers
+git clone https://github.com/netflyapp/fluentcrm-mcp-server.git
+cd fluentcrm-mcp-server
+npm install
+npm run build
+
+# 2. Store credentials in ~/.config/aidevops/mcp-env.sh:
+export FLUENTCRM_API_URL="https://your-domain.com/wp-json/fluent-crm/v2"
+export FLUENTCRM_API_USERNAME="your_username"
+export FLUENTCRM_API_PASSWORD="your_application_password"
+```
+
+**For OpenCode** - use bash wrapper pattern (disabled globally, enabled per-agent):
+
+```json
+{
+  "fluentcrm": {
+    "type": "local",
+    "command": ["/bin/bash", "-c", "source ~/.config/aidevops/mcp-env.sh && node ~/.local/share/mcp-servers/fluentcrm-mcp-server/dist/fluentcrm-mcp-server.js"],
+    "enabled": false
+  }
+}
+```
+
+**For Claude Desktop**:
+
+```json
+{
+  "mcpServers": {
+    "fluentcrm": {
+      "command": "node",
+      "args": ["~/.local/share/mcp-servers/fluentcrm-mcp-server/dist/fluentcrm-mcp-server.js"],
+      "env": {
+        "FLUENTCRM_API_URL": "https://your-domain.com/wp-json/fluent-crm/v2",
+        "FLUENTCRM_API_USERNAME": "your_username",
+        "FLUENTCRM_API_PASSWORD": "your_application_password"
+      }
+    }
+  }
+}
+```
+
+**Per-Agent Enablement**: The `services/crm/fluentcrm.md` subagent has `fluentcrm_*: true` in its tools section. Main agents (`sales.md`, `marketing.md`) reference this subagent for CRM operations.
+
+**Available Tools**: Contacts, Tags, Lists, Campaigns, Email Templates, Automations, Webhooks, Smart Links, Dashboard Stats.
+
+See `services/crm/fluentcrm.md` for detailed documentation.
+
 ## 🔧 **Configuration Examples**
 
 ### **Advanced Chrome DevTools Configuration**