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

Use directly with npx (Recommended)

npx hypothesis-canvas-mcp

Or install globally

npm install -g hypothesis-canvas-mcp

Setup for Claude Desktop

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

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

Usage Examples

Create a Canvas Snapshot

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

Create a Password-Protected Snapshot

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...]

Retrieve a Canvas Snapshot

Get the canvas snapshot with share ID: abc123def

If password protected:

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

Available Tools

create_canvas_snapshot

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

get_canvas_snapshot

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

Hypothesis Canvas

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

Business Model Canvas

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

Opportunity Canvas

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

Development

# 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)