Everything your AI agent needs to build & ship a webapp

Pick a prompt, ship a webapp

Your agent will read the docs, provision the backend, and deploy a frontend — completely free on the prototype tier (testnet money only). Pick an idea and copy the prompt.

Read https://run402.com/llms-cli.txt.

Build a shared todo list for me and my partner:
- Each todo has a title, done status, and who it's assigned to
- We each have our own account and we see shared items

Read https://run402.com/llms-cli.txt.

Build a startup landing page with email waitlist:
- Collect email, name, and timestamp
- Make it polished and beautiful

Read https://run402.com/llms-cli.txt.

Build a group expense splitter for a trip with 6 friends:
- Track who paid what, split between whom, and running balances
- Each person gets their own account
- Show who owes whom

Read https://run402.com/llms-cli.txt.

Build an event scheduling poll, like Doodle:
- People can sign up and vote on available time slots
- Show the winning time

Read https://run402.com/llms-cli.txt.

Build a shared family recipe book:
- Each recipe has a title, ingredients, instructions, and a photo
- Make it browsable and beautiful

Read https://run402.com/llms-cli.txt.

Build an apartment hunting tracker for me and my roommate:
- Track listings with address, price, sqft, pros, cons, and our ratings
- We can both add and rate places

Read https://run402.com/llms-cli.txt.

Build me a personal micro-blog:
- I can post short thoughts and links with tags
- Anyone can read it, only I can post

Read https://run402.com/llms-cli.txt.

Build a gift registry for my birthday:
- Guests can see items and claim them
- No one sees who claimed what, so no duplicate gifts

Read https://run402.com/llms-cli.txt.

Build me a workout tracker:
- Track exercises, sets, reps, and weight with dates
- Show my progress over time
- Keep my data private

Read https://run402.com/llms-cli.txt.

Build a flash card app for learning Spanish:
- Each card has a front and back, with spaced repetition
- Pre-load 50 common phrases

What your agent gets (full stack)

Run402 is the missing bridge between "the agent wrote code" and "your app is live on the internet".

Pricing (prepaid, hard-capped)

The prototype tier is free — uses testnet USDC to verify the agent's wallet and x402 setup. No real money. Production tiers are prepaid leases (no overages, no surprise bills).

Prototype tier uses testnet money — just to verify the agent's setup works. For production (hobby/team), your agent pays with real USDC on Base via x402, or you can buy Run402 credits with a credit card via Stripe.

How it works (one call, full app)

# One x402 payment, full app deployed:
POST https://api.run402.com/v1/deploy/prototype
{
  "name": "my-todo-app",
  "migrations": "CREATE TABLE todos (...);",
  "site": [{ "file": "index.html", "data": "..." }],
  "subdomain": "my-todos"
}

# => https://my-todos.run402.com (live!)
# => project_id, anon_key, service_key returned

Database + tables + auth + site + functions + subdomain — one payment, everything live. Or build step-by-step with individual endpoints. See /llms.txt for both approaches.

Works with OpenClaw, MCP, or plain HTTP

Run402 is agent-native: your agent can integrate however it prefers. The canonical docs are /llms.txt.

HTTP    Call the API directly: https://api.run402.com
MCP     npx run402-mcp
OpenClaw Run402 skill includes deploy_site + provisioning tools

What is x402?

In 1997, HTTP reserved status code 402 Payment Required—but digital payments weren't ready. Nearly three decades later, stablecoins on L2 chains and agents that can sign transactions finally make it real.

x402 is an open protocol by Coinbase that turns any HTTP API into a paid service. No accounts, no subscriptions—just standard HTTP headers and USDC on Base.

# How x402 works:
1. Agent sends HTTP request      → Server returns 402 Payment Required
2. Agent signs USDC transfer      → Retries with payment proof
3. Server verifies and settles    → Returns 200 OK + resource

# Settlement: ~2 seconds. Gas: sub-cent on Base L2.
# The agent never pays gas — the facilitator submits the tx.

What is MPP?

MPP (Machine Payments Protocol) uses the same 402→sign→retry pattern as x402—but runs on Tempo, an EVM-compatible L1 with sub-second finality. No gas token: fees are paid in stablecoins (pathUSD). The same private key works on both chains.

MPP is an open protocol by Stripe. Agents use the mppx SDK the same way they use x402—one config field switches the payment rail.

# How MPP works:
1. Agent sends HTTP request      → Server returns 402 Payment Required
2. Agent signs pathUSD transfer  → Retries with payment proof
3. Server verifies and settles    → Returns 200 OK + resource

# Settlement: sub-second on Tempo L1.
# No gas token — fees paid in stablecoins (pathUSD).

Why this matters (for humans)

Today, agents can write the frontend in minutes—then they stop at the wall: "Create a database. Set up auth. Configure storage. Deploy hosting. Paste me the keys."

Run402 removes the wall. With x402 or MPP, the agent can procure infrastructure the moment it needs it—under a prepaid cap—and hand you a live URL.

# Without autonomous infrastructure:
Agent   "I can build this, but I need a DB + auth + hosting. Can you set it up?"
Human   Signs up → configures → copies keys → pastes back
Time    10–30 minutes of overhead, per project

# With Run402:
Agent   Pays + provisions over HTTP (x402 or MPP)
Result  Backend + frontend hosting, ready
Time    seconds, minimal human involvement

Durability & ops

Database     AWS Aurora Serverless v2 (Postgres 16), multi-AZ
Sites        CloudFront + S3 (wildcard *.run402.com, SPA fallback)
Encryption  At rest (Aurora + S3) and in transit (TLS)
Backups     Automated, 7-day retention
Isolation   Each project gets its own Postgres schema
Status      api.run402.com/health

Project lifecycle

Leases are prepaid with hard caps. No overage charges, no surprise bills.

# After lease expires:
Day 0    Lease expires — project becomes read-only
Day 7    Grace period ends — project is archived
Day 37   Permanent deletion

# Renew anytime before deletion:
POST /v1/projects/:id/renew  (x402 or MPP)

Your agent wants to ship.

It just doesn't know Run402 exists yet.

Do this: paste this into your agent's chat.