ProtoWall

CLI and MCP server for managing ProtoWall projects, invites, and access.

Install

pip install protowall

Or from source:

git clone https://github.com/protowall/cli.git
cd cli
pip install .

API Key

Create an API key at protowall.app/dashboard and set it:

export PROTOWALL_API_KEY="pw_sk_your_key_here"

CLI

protowall projects                          # List projects
protowall project <slug>                    # Get project detail
protowall project create <name> <url>       # Create project
protowall project delete <slug>             # Delete project
protowall invites <slug>                    # List invites
protowall invite <slug> <email>             # Send invite
protowall revoke <slug> <invite-id>         # Revoke access
protowall audit <slug>                      # View audit log
protowall usage <slug> [7d|30d]             # Project usage analytics (Pro)
protowall reviewer <slug> <invite-id> [7d|30d]   # Per-reviewer engagement (Pro)
protowall sessions <slug> <invite-id>       # List sessions + cached AI summaries (Pro, read-only)
protowall summarize-session <slug> <invite-id> <session-start>   # Generate session summary (Pro, uses cap)
protowall rotate-secret <slug>              # Rotate origin secret

All commands output JSON for easy piping:

protowall projects | jq '.[0].slug'

MCP Server

Add to your agent's MCP config:

Claude Code (~/.claude/settings.json or project .claude/settings.json):

{
  "mcpServers": {
    "protowall": {
      "command": "protowall-mcp",
      "env": {
        "PROTOWALL_API_KEY": "pw_sk_your_key_here"
      }
    }
  }
}

Cursor (.cursor/mcp.json in your project root):

{
  "mcpServers": {
    "protowall": {
      "command": "protowall-mcp",
      "env": {
        "PROTOWALL_API_KEY": "pw_sk_your_key_here"
      }
    }
  }
}

Available Tools

Tool	Description
list_projects	List all projects you own
create_project	Create a new project with an NDA wall
send_invite	Invite a reviewer by email
revoke_access	Revoke a reviewer's access immediately
get_audit_log	View audit events for a project
rotate_secret	Rotate the origin secret
get_project_usage	Project-wide engagement rollup over 7 or 30 days (Pro)
get_reviewer_engagement	Per-reviewer engagement rollup with top paths and timeline (Pro)
list_reviewer_sessions	List a reviewer's sessions with cached AI summaries (Pro, read-only — no cap consumed)
summarize_reviewer_session	Generate or fetch a cached AI summary for one session (Pro, counts against monthly cap)

Once configured, ask your agent things like:

• "Create a ProtoWall project for my prototype at https://my-app.onrender.com"
• "Invite reviewer@example.com to my-project"
• "Show the audit log for my-project"
• "Who looked at my-project this week and what did they spend time on?"
• "Pull the engagement breakdown for the reviewer with invite id cvw80…"
• "Summarize what acme@corp.com did during their most recent session on my-project"

Environment Variables

Variable	Required	Default
PROTOWALL_API_KEY	Yes	—
PROTOWALL_API_URL	No	https://protowall.app