README.md
Autonomous infra for Coding Agents paid by X402
run402 — MCP Server, CLI & OpenClaw Skill
Developer tools for Run402 — provision Postgres databases, deploy static sites, serverless functions, generate images, and manage agent allowances. Available as an MCP server, an OpenClaw skill, and a CLI.
English | 简体中文
Integrations
| Interface | Use when... |
|---|---|
| `cli/` | Terminal, scripts, CI/CD |
| `openclaw/` | OpenClaw agent (no MCP required) |
| MCP server (this package) | Claude Desktop, Cursor, Cline, Claude Code |
Quick Start
npx run402-mcp
MCP Tools
| Tool | Description |
|---|---|
provision_postgres_project |
Provision a Postgres database. Handles x402 payment. Saves credentials locally. |
run_sql |
Execute SQL (DDL or queries). Returns markdown table. |
rest_query |
Query/mutate via PostgREST. GET/POST/PATCH/DELETE with query params. |
setup_rls |
Apply row-level security templates to tables. |
get_schema |
Introspect database schema — tables, columns, types, constraints, RLS policies. |
get_usage |
Get project usage report — API calls, storage, limits, lease expiry. |
upload_file |
Upload text content to project storage. |
download_file |
Download a file from project storage. |
delete_file |
Delete a file from project storage. |
list_files |
List files in a storage bucket. |
deploy_function |
Deploy a serverless function (Node 22) to a project. |
invoke_function |
Invoke a deployed function via HTTP. |
get_function_logs |
Get recent logs from a deployed function. |
list_functions |
List all deployed functions for a project. |
delete_function |
Delete a deployed function. |
set_secret |
Set a project secret. Injected as process.env in functions. |
list_secrets |
List secret keys for a project (values not shown). |
delete_secret |
Delete a secret from a project. |
deploy_site |
Deploy static site. Free with active tier. Returns live URL. |
claim_subdomain |
Claim custom subdomain (e.g. myapp.run402.com). Free. |
delete_subdomain |
Release a subdomain. |
list_subdomains |
List all subdomains claimed by a project. |
bundle_deploy |
One-call full-stack deploy: database + migrations + RLS + secrets + functions + site + subdomain. |
browse_apps |
Browse public apps available for forking. |
fork_app |
Fork a published app into a new project. |
publish_app |
Publish a project as a forkable app. |
list_versions |
List published versions of a project. |
get_quote |
Get tier pricing. Free, no auth required. |
set_tier |
Subscribe, renew, or upgrade tier. Auto-detects action. Handles x402 payment. |
archive_project |
Archive a project and remove from local key store. |
check_balance |
Check billing account balance for an agent allowance address. |
list_projects |
List all active projects for an agent allowance address. |
allowance_status |
Check local agent allowance status — address, network, funding. |
allowance_create |
Create a new local agent allowance (Base Sepolia testnet). |
allowance_export |
Export the local agent allowance address. |
request_faucet |
Request free testnet USDC from the Run402 faucet. |
generate_image |
Generate a PNG image from a text prompt. $0.03 via x402. |
Client Configuration
CLI
A standalone CLI is available in the `cli/` directory.
npm install -g run402
run402 allowance create
run402 allowance fund
run402 deploy --tier prototype --manifest app.json
See `cli/README.md` for full usage.
OpenClaw
A standalone skill is available in the `openclaw/` directory — no MCP server required. It calls the Run402 API directly via Node.js scripts.
cp -r openclaw ~/.openclaw/skills/run402
cd ~/.openclaw/skills/run402/scripts && npm install
See `openclaw/README.md` for details.
MCP Clients
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"run402": {
"command": "npx",
"args": ["-y", "run402-mcp"]
}
}
}
Cursor
Add to .cursor/mcp.json in yo
Tools (37)
provision_postgres_projectProvision a Postgres database.run_sqlExecute SQL (DDL or queries).rest_queryQuery/mutate via PostgREST.setup_rlsApply row-level security templates to tables.get_schemaIntrospect database schema.get_usageGet project usage report.upload_fileUpload text content to project storage.download_fileDownload a file from project storage.delete_fileDelete a file from project storage.list_filesList files in a storage bucket.deploy_functionDeploy a serverless function (Node 22) to a project.invoke_functionInvoke a deployed function via HTTP.get_function_logsGet recent logs from a deployed function.list_functionsList all deployed functions for a project.delete_functionDelete a deployed function.set_secretSet a project secret.list_secretsList secret keys for a project.delete_secretDelete a secret from a project.deploy_siteDeploy static site.claim_subdomainClaim custom subdomain.delete_subdomainRelease a subdomain.list_subdomainsList all subdomains claimed by a project.bundle_deployOne-call full-stack deploy.browse_appsBrowse public apps available for forking.fork_appFork a published app into a new project.publish_appPublish a project as a forkable app.list_versionsList published versions of a project.get_quoteGet tier pricing.set_tierSubscribe, renew, or upgrade tier.archive_projectArchive a project and remove from local key store.check_balanceCheck billing account balance for an agent allowance address.list_projectsList all active projects for an agent allowance address.allowance_statusCheck local agent allowance status.allowance_createCreate a new local agent allowance.allowance_exportExport the local agent allowance address.request_faucetRequest free testnet USDC from the Run402 faucet.generate_imageGenerate a PNG image from a text prompt.Configuration
claude_desktop_config.json
{"mcpServers": {"run402": {"command": "npx", "args": ["-y", "run402-mcp"]}}}Try it
→Provision a new Postgres database for my project.
→Deploy my static site and claim a custom subdomain.
→Check my current agent allowance status and balance.
→Generate a PNG image of a futuristic city using the image generation tool.
→List all my deployed serverless functions and get the logs for the latest one.