mcp-server-cantrip

MCP (Model Context Protocol) server for Cantrip — the AI-powered GTM engine for solo founders.

This server lets any MCP-compatible agent (Claude, Cursor, etc.) interact with Cantrip's project management, gap analysis, and entity CRUD through the standard MCP tool protocol.

Architecture

Agent (Claude, etc.) ── MCP protocol (stdio) ──> mcp-server-cantrip ── HTTP POST ──> cantrip daemon

The MCP server is a thin translation layer. It converts MCP tool calls into {command, args, flags} JSON envelopes and POSTs them to the cantrip daemon. Zero business logic — identical contract to the CLI and React UI.

Installation

npm install -g mcp-server-cantrip

Or run directly:

npx mcp-server-cantrip

Configuration

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cantrip": {
      "command": "npx",
      "args": ["mcp-server-cantrip"],
      "env": {
        "CANTRIP_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Add to ~/.claude/mcp.json globally:

{
  "mcpServers": {
    "cantrip": {
      "command": "npx",
      "args": ["mcp-server-cantrip"],
      "env": {
        "CANTRIP_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

Project Context (.cantrip.json)

Each project directory contains a .cantrip.json file that tells Cantrip which project to target:

{
  "project": "my-saas"
}

This file is created automatically by cantrip_init (new project) or cantrip_connect (existing project). The agent manages it — you don't need to create it manually.

Multiple projects on the same machine? Each project directory gets its own .cantrip.json. The agent switches context by working in the right directory.

Tools (17)

Setup

Core Commands

Review

Entity CRUD (generic)

Supported entity types: icp, pain_point, value_prop, experiment, channel, competitor, contact

License

MIT