Skip to main content

Motorical MCP Server

MCP tools for transactional HTTP send and delivery inspection on Motorical. The server lets AI agents call Motorical APIs (not only read docs). It runs locally over stdio (Cursor, Claude Desktop, and other MCP clients).

Source: packages/motorical-mcp in the Motorical backend monorepo (@motorical/mcp).

Tools (v1)​

ToolNeedsWhat it does
motorical_get_send_status—HTTP Send API health
motorical_mint_public_tokenak_live_…Mint Public Analytics bearer
motorical_list_motor_blocksbearer (auto)List motor blocks
motorical_send_emailmk_live_…POST /v1/send (default dryRun: true)
motorical_get_messagebearer (auto)Message by UUID
motorical_get_message_eventsbearer (auto)Lifecycle events

Resources: motorical://docs/llms.txt, motorical://docs/openapi.json
Prompt: motorical_integrate_send

Real sends require dryRun: false and confirmRealSend: true.

Cursor configuration​

{
  "mcpServers": {
    "motorical": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/motorical-mcp/src/index.js"],
      "env": {
        "MOTORICAL_MK_API_KEY": "mk_live_…",
        "MOTORICAL_AK_API_KEY": "ak_live_…",
        "MOTORICAL_MOTOR_BLOCK_ID": "your-motor-block-uuid",
        "MOTORICAL_DEFAULT_FROM": "noreply@yourdomain.com"
      }
    }
  }
}

Downloadable template: motorical-mcp.cursor.json

Environment variables​

See the package README. Keys are created in the Motorical dashboard (Motor Block API keys + Account API keys).