hypothesis-canvas-mcp

MCP (Model Context Protocol) server for Hypothesis Canvas - Interactive canvas creation and editing through LLM interfaces. This server allows AI assistants to create and retrieve shareable snapshots of various canvas types through the Hypothesis Canvas web application.

Features

- Create shareable canvas snapshots with custom URLs
- Support for all canvas types (Business Model, Opportunity, Hypothesis)
- Optional password protection and expiration settings
- Retrieve shared canvas content via share ID
- No authentication required - works with public API

Installation

$3

``bash
npx hypothesis-canvas-mcp
`

$3

`bash
npm install -g hypothesis-canvas-mcp
`

$3

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

`json
{
"mcpServers": {
"hypothesis-canvas": {
"command": "npx",
"args": ["hypothesis-canvas-mcp"],
"env": {
"CANVAS_API_URL": "https://hypothesis-canvas-llm-webapp.vercel.app"
}
}
}
}
`

Usage Examples

$3

`
Create a hypothesis canvas snapshot with the following:
- Title: "AI Code Review Assistant"
- Description: "Automated code review using LLMs"
- Cells:
- value-proposition: "Reduce code review time by 80%"
- customer-segments: "Development teams at tech companies"
- key-metrics: "Review time, Bug detection rate"
- channels: "VS Code marketplace, GitHub integration"
- revenue-streams: "Subscription model"
`

The server will return a shareable URL like:
https://hypothesis-canvas-llm-webapp.vercel.app/share/abc123def

$3

`
Create a business model canvas with password protection:
- Title: "Confidential Business Plan"
- Canvas Type: business
- Password: "secure123"
- Expires in: 24 hours
- Max views: 10
- Cells: [your canvas content...]
`

$3

`
Get the canvas snapshot with share ID: abc123def
`

If password protected:

`
Get the canvas snapshot with share ID: abc123def and password: secure123
`

Available Tools

$3

Creates a shareable snapshot of a canvas.

Parameters:

- canvasType (required): 'business', 'opportunity', or 'hypothesis'
- title (required): Title for the snapshot
- description (optional): Additional description
- cells (required): Array of cell objects with:
- id: Cell identifier (e.g., "value-proposition", "customer-segments")
- content: Cell content text
- shareSettings (optional):
- isPublic: Make snapshot publicly accessible (default: true)
- password: Password protect the snapshot
- expiresIn: Expiration time in hours
- maxViews: Maximum number of views allowed

$3

Retrieves a canvas snapshot by share ID.

Parameters:

- shareId (required): The unique share ID
- password (optional): Password if the snapshot is protected

Cell IDs by Canvas Type

$3

- purpose
- vision
- means
- advantage
- metrics
- valueProposition
- obviousProblem
- latentProblem
- alternatives
- situation
- channel
- trend
- revenueModel
- marketSize

$3

- value-propositions
- customer-segments
- channels
- customer-relationships
- revenue-streams
- key-resources
- key-activities
- key-partnerships
- cost-structure

$3

- problems
- solution-ideas
- users-customers
- user-outcomes
- user-benefits
- adoption-strategy
- business-benefits
- business-metrics
- budget-resources

Development

`bash


Run in development mode

pnpm dev

Build for production

pnpm build

Run tests

pnpm test
`

Environment Variables

- CANVAS_API_URL`: The URL of the canvas webapp API (defaults to https://hypothesis-canvas-llm-webapp.vercel.app)