Skip to main content

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

Project description

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

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…"

Environment Variables

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

protowall-0.2.0.tar.gz (7.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

protowall-0.2.0-py3-none-any.whl (6.7 kB view details)

Uploaded Python 3

File details

Details for the file protowall-0.2.0.tar.gz.

File metadata

  • Download URL: protowall-0.2.0.tar.gz
  • Upload date:
  • Size: 7.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for protowall-0.2.0.tar.gz
Algorithm Hash digest
SHA256 ee399f189d7024a7ad5cdff03329e85ef6a9774d6ee3a21e350ec9f0008c3a5e
MD5 8feacb92bd82dfd3964f3c576be96897
BLAKE2b-256 168c8831c69581a7550e3321ec08b12fa6870c8fca05c5c88d6301203e54fd7a

See more details on using hashes here.

File details

Details for the file protowall-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: protowall-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 6.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for protowall-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 011ef6c0b3aac71a4b4687aa3e2febdd9537467ae51fb3cd9655a1462e947675
MD5 dedc7ca679e5bdcd01a91cfe58a1b611
BLAKE2b-256 553323bcd0f5bf948c703cc7248b8e825d7bfb3b5c25f8ec6262624460609699

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page