AI Assistant & Remote MCP

5 min read

In-App AI Assistant

The Cacuda dashboard includes a built-in AI assistant at /automod/assistant that can help you:

Create and configure automod pipelines from natural language descriptions
Explain how to integrate with WordPress, Drupal, webhooks, or MCP
Test pipelines with sample data and review execution results
Look up documentation on node types, credit costs, and configuration

The assistant has direct access to your automods and can create, update, validate, and test pipelines on your behalf. All created automods start in draft status so you can review them in the flow builder before activating.

Remote MCP Endpoints

Cacuda exposes two MCP (Model Context Protocol) endpoints over Streamable HTTP, enabling external AI assistants like Cursor, Claude Desktop, or custom agents to interact with your pipelines and documentation programmatically.

Pipeline MCP

POST https://api.cacuda.com/mcp/pipeline

Tools: list/create/update/test automods, validate flows, manage status, view executions, list node types.

Documentation MCP

POST https://api.cacuda.com/mcp/docs

Tools: list docs, read docs by slug, search docs by keyword.

Authentication

Both MCP endpoints require an API key in the X-API-Key header. Generate an API key at /account.

Connecting from Cursor or Claude Desktop

Add to your MCP settings file:

{
  "mcpServers": {
    "cacuda-pipeline": {
      "url": "https://api.cacuda.com/mcp/pipeline",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    },
    "cacuda-docs": {
      "url": "https://api.cacuda.com/mcp/docs",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Note: These are remote HTTP MCP servers. For clients that only support stdio transport, use the @cacuda/mcp-server npm package instead (see MCP Server docs).

MCP Protocol

The endpoints speak standard MCP over JSON-RPC 2.0. Supported methods:

Method	Description
`initialize`	Handshake — returns server info and capabilities
`tools/list`	Lists all available tools with schemas
`tools/call`	Executes a tool with the given arguments

Example: List Tools

curl -X POST https://api.cacuda.com/mcp/pipeline \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Example: Call a Tool

curl -X POST https://api.cacuda.com/mcp/docs \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_docs",
      "arguments": { "query": "webhook integration" }
    }
  }'

Next: MCP Server (stdio)