prowpt-mcp-server 0.3.0

MCP server for Prowpt.ai — lets AI agents create, edit, and publish web apps. Supports stdio (local) and Streamable HTTP (remote) transports.

Prowpt.ai MCP Server

MCP (Model Context Protocol) server that lets AI agents create, edit, and publish web apps on Prowpt.ai.

Setup

1. Get an API key

Go to prowpt.ai/settings → API Keys → Create a new key with the scopes you need.

2. Install

pip install prowpt-mcp-server
# or
pipx install prowpt-mcp-server

3. Configure your AI tool

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "prowpt": {
      "command": "prowpt-mcp",
      "env": {
        "PROWPT_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

Claude Code:

export PROWPT_API_KEY="pk_live_your_key_here"
prowpt-mcp

Environment variables:

Variable	Required	Default	Description
PROWPT_API_KEY	Yes (stdio only)	—	Your Prowpt API key
PROWPT_API_URL	No	https://api.prowpt.ai	API base URL

Transports

The server supports two transports:

stdio (default)

Used by local IDEs like Cursor and Claude Code. The CLI authenticates with the PROWPT_API_KEY environment variable and speaks MCP over stdin/stdout.

prowpt-mcp                    # reads PROWPT_API_KEY from env
prowpt-mcp --api-key pk_...   # or pass explicitly

Streamable HTTP (remote)

Used by public connectors (Claude.ai custom servers, ChatGPT Apps, etc.). The server listens on an HTTP endpoint at /mcp; every request must carry an Authorization: Bearer <token> header. The token is either a Prowpt API key (pk_live_...) or — once the Prowpt OAuth AS is live — a JWT issued by https://prowpt.ai/oauth/*. Tokens are forwarded verbatim to the Prowpt REST API, which owns all scope/rate-limit enforcement.

pip install "prowpt-mcp-server[http]"
prowpt-mcp --transport http --bind 0.0.0.0:8001

Useful flags:

Flag	Description
--transport http	Run the HTTP transport (default: stdio)
--bind HOST:PORT	Listen address (default: 0.0.0.0:8001)
--stateful	Use session-state mode (default: stateless)
--json-response	Return plain JSON instead of SSE streams
--no-auth	Disable bearer-token auth (local debugging only)
--api-url URL	Prowpt REST API base URL

The server also exposes GET /healthz for liveness probes. Unauthenticated requests return 401 with a WWW-Authenticate: Bearer challenge pointing at the OAuth protected-resource metadata URL, so MCP clients can auto-discover the authorisation server.

OAuth-issued tokens (used by Claude.ai and ChatGPT directory connectors) are short-lived JWTs backed by an api_keys row with origin='oauth'. Each connector key carries a default rate limit of 20 requests per minute and a 25-credit per-UTC-day spend cap for credit-consuming actions (send_prompt, /api/generate/*). Users can revoke any connection from Settings → API Keys in the Prowpt web app.

Getting Started

After installation, the recommended first step for any code-generation task is to fetch the project context:

get_project_context(project_id=123)

This returns the full conventions, available record types, templates, i18n state, enabled packages, and subscription info for the project — everything the agent needs to write correct, Prowpt-compliant code.

The server also exposes two static resources that agents can read at any time:

Resource URI	Description
prowpt://docs/quickstart	Quick-start guide with tool summaries
prowpt://docs/code-guidelines	Comprehensive code conventions: PROJECT_CONFIG shape, auth patterns, i18n, records API, routing rules, component templates, and best practices

Available Tools

Project Management

• list_projects — List all projects
• get_project — Get project details
• get_project_context — Get full project context for writing correct code (stack, conventions, record types, templates, i18n state)
• create_project — Create a new app
• update_project — Update project settings
• delete_project — Delete a project
• clone_project — Clone a project
• publish_project — Publish to live
• deploy_project — Deploy to hosting

Source Code

• list_source_files — List files in a project
• read_source_file — Read a file's content
• write_source_files — Write/update files
• get_preview_url — Get preview URL
• get_source_versions — Version history
• restore_source_version — Restore a version

AI Assistant (uses Prowpt credits)

• send_prompt — Send instruction to Prowpt AI. Transport-aware: on stdio (Cursor / Claude Code) it blocks up to 5 minutes and returns the final result; on HTTP (remote connectors with short tool-call timeouts) it returns {run_id, status: "queued"} immediately and the caller polls get_assistant_status(project_id, run_id=...) until the run terminates.
• accept_preview — Accept AI changes
• get_assistant_status — Check generation status. Pass run_id to poll a specific async run (HTTP flow); omit it to fetch the latest active run for the project (stdio flow).

Records & Data

• list_record_types / create_record_type / update_record_type
• list_records / create_record / update_record / delete_record

Workflows

• list_workflows / create_workflow / update_workflow / delete_workflow
• execute_workflow / get_workflow_executions

Packages / Dependencies

• list_catalog — Browse all available npm packages in the platform catalog
• list_project_packages — List packages enabled for a project (with update info)
• add_package — Enable a catalog package for a project
• remove_package — Remove a package from a project

Assets

• list_assets / upload_asset / delete_asset

Translations

• get_translations / update_translations

Email Templates

• list_email_templates — List all templates (system + custom)
• get_email_template — Get a template by slug (full HTML body + variables)
• upsert_email_template — Create or update a template
• delete_email_template — Delete a custom template
• preview_email_template — Render a preview with sample variables
• send_test_email — Send a test email to a given address
• seed_email_templates — Seed factory defaults
• reset_system_templates — Reset system templates to defaults

Payments (Stripe Connect)

• connect_stripe — Start Stripe Connect onboarding for a project
• get_stripe_status — Check Stripe connection status
• disconnect_stripe — Remove Stripe Connect link

Billing

• get_usage / get_credits / purchase_credit_pack / get_account_info

Development

cd prowpt-mcp-server
pip install -e .
prowpt-mcp --api-key pk_live_test_key --api-url http://localhost:8000

License

MIT