prowpt-mcp-server
MCP server for Prowpt.ai β lets AI agents create, edit, and publish web apps
Ask AI about prowpt-mcp-server
Powered by Claude Β· Grounded in docs
I know everything about prowpt-mcp-server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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 projectsget_projectβ Get project detailsget_project_contextβ Get full project context for writing correct code (stack, conventions, record types, templates, i18n state)create_projectβ Create a new appupdate_projectβ Update project settingsdelete_projectβ Delete a projectclone_projectβ Clone a projectpublish_projectβ Publish to livedeploy_projectβ Deploy to hosting
Source Code
list_source_filesβ List files in a projectread_source_fileβ Read a file's contentwrite_source_filesβ Write/update filesget_preview_urlβ Get preview URLget_source_versionsβ Version historyrestore_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 pollsget_assistant_status(project_id, run_id=...)until the run terminates.accept_previewβ Accept AI changesget_assistant_statusβ Check generation status. Passrun_idto 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_typelist_records/create_record/update_record/delete_record
Workflows
list_workflows/create_workflow/update_workflow/delete_workflowexecute_workflow/get_workflow_executions
Packages / Dependencies
list_catalogβ Browse all available npm packages in the platform cataloglist_project_packagesβ List packages enabled for a project (with update info)add_packageβ Enable a catalog package for a projectremove_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 templatedelete_email_templateβ Delete a custom templatepreview_email_templateβ Render a preview with sample variablessend_test_emailβ Send a test email to a given addressseed_email_templatesβ Seed factory defaultsreset_system_templatesβ Reset system templates to defaults
Payments (Stripe Connect)
connect_stripeβ Start Stripe Connect onboarding for a projectget_stripe_statusβ Check Stripe connection statusdisconnect_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
