protowall 0.3.0

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

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 [e-mail] 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 [e-mail] 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