# Cantrip

Manage product strategy projects by tracking Ideal Customer Profiles, pain points, and value propositions. Automate market research and entity enrichment using gap analysis to identify new growth opp…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add cantrip/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list cantrip/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get cantrip/mcp-server cantrip_connect

# Call a tool
npx -y @smithery/cli@latest tool call cantrip/mcp-server cantrip_connect '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--cantrip.run.tools`

## Tools (19)

- `cantrip_connect` — Connect this workspace to a Cantrip project by writing a .cantrip.json file. Call without arguments to check the curren…
- `cantrip_status` — Check daemon health, authentication, and current project. Returns setup instructions when CANTRIP_API_KEY is missing.
- `cantrip_init` — Create a new project and connect this workspace to it. Optionally ingests a product brief to extract ICPs, pain points,…
- `cantrip_project` — Manage projects. Actions: list (all projects), update (name/description), delete (project + all data).
- `cantrip_snapshot` — Browse project data at three zoom levels: project overview, entity type listing, or single entity detail.
- `cantrip_review` — List all items pending review (inferred entities and open escalations).
- `cantrip_review_accept` — Accept an inferred entity, marking it as verified ground truth.
- `cantrip_review_reject` — Reject an inferred entity (soft-delete, kept for history).
- `cantrip_review_resolve` — Resolve an open escalation with a resolution message.
- `cantrip_review_dismiss` — Dismiss an inferred entity or open escalation without accepting or rejecting.
- `cantrip_next` — List gap-analysis opportunities that would move the project closer to ideal state.
- `cantrip_next_prompt` — Generate a context-rich LLM prompt for an opportunity. Zero credit cost.
- `cantrip_next_run` — Execute an enrichment opportunity with AI. Runs LLM-powered enrichment that creates or updates entities.
- `cantrip_history` — Query the append-only audit trail of all actions taken on the project.
- `cantrip_meter_balance` — Check remaining credits, reserved credits (in-progress), and total balance.
- `cantrip_meter_history` — View recent credit transactions (debits, purchases, and running balance).
- `cantrip_meter_tiers` — View available credit packs with tier name, credits included, and price.
- `cantrip_entity_add` — Create a new entity (icp, pain_point, value_prop, experiment, channel, competitor, contact). Automatically marked as ac…
- `cantrip_entity_edit` — Edit an existing entity. Fields vary by type (same as cantrip_entity_add).

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get cantrip/mcp-server <tool-name>
```