← Back to run402.com/humans

Frequently Asked Questions

Quick answers for developers and agent builders.

What is Run402?

Run402 is full-stack cloud infrastructure designed for AI agents: PostgreSQL databases, REST APIs, authentication, file storage, row-level security, and static site hosting. Use the CLI by default, the typed SDK for scripting, or MCP for tool-native hosts; these run on the HTTP API. Infrastructure is provisioned and paid for programmatically — no signups needed.

How do I get started?

Paste https://run402.com/llms-cli.txt into your AI agent's chat and describe what you want to build. The agent reads the docs, provisions a backend, and deploys a frontend. Use the typed SDK for scripting. Direct HTTP integrations have a separate API reference.

What is x402?

x402 is an open payment protocol by Coinbase that uses HTTP status code 402 (Payment Required). Your agent pays for infrastructure with USDC on Base — sub-cent gas, ~2 second settlement. No accounts or subscriptions needed for x402 payments.

What is MPP?

MPP (Machine Payments Protocol) is Stripe's open protocol for the same 402 handshake. Run402 accepts it on two settlement rails: pathUSD on Tempo (Stripe's payments L1, sub-second finality, the same EVM key as x402) and bitcoin over the Lightning Network (sats, mainnet). Every paid endpoint takes x402 and MPP at the same price.

Can my agent pay in bitcoin?

Yes, two ways. 1) run402 init lightning gives the agent its own budgeted Lightning wallet on Run402's Hub; tiers and image generation are then paid in sats over MPP, with x402 as the fallback. 2) run402 billing topup --sats 5000 mints a Lightning invoice that any wallet — a phone, another agent — can pay; the organization's balance is credited at the quoted dollar value. See MPP support.

Can I also pay with a credit card?

Yes. You can buy Run402 credits with a credit card via Stripe. Visit /billing/ with your agent's wallet address to add funds. Your agent's x402 payments are then settled from the credit balance automatically. This is one of two paths to production — the other is funding the agent's wallet directly with USDC on Base.

How much does it cost?

The prototype tier is free. It uses testnet USDC ($0 real money) to verify the agent's wallet and x402 payment setup work. You get a real database with a perpetual lease, 250 MB storage, 500K API calls, and a 1 MB max function bundle. For production, hobby projects are $5 (30-day lease, 1 GB, 5M calls, 5 MB max function bundle) and team projects are $20 (30-day lease, 10 GB, 50M calls, 25 MB max function bundle). All leases are prepaid with hard caps — no overage charges.

If you also need on-chain signing (KMS signers), each wallet costs $0.04/day ($1.20/month) plus $0.000005 per contract call (KMS sign fee). Chain gas is at-cost. See /billing/ for the full breakdown — KMS signers are non-custodial.

How do I pay for production tiers?

Two paths: 1) Buy Run402 credits with a credit card via Stripe — visit /billing/ with your agent's wallet address. 2) Fund your agent's wallet with real USDC on Base (x402) or pathUSD on Tempo (MPP), or give it a Lightning wallet and let it pay in sats (MPP over Bitcoin Lightning); the agent pays autonomously either way. Both paths use the same API — no code changes needed.

What happens when my lease expires?

Your live site keeps serving end users the entire time. You get ~104 days of grace, escalating gradually: day 0–14 "past due" (everything works, warning email), day 14–44 "frozen" (deploys and secret rotation return 402 but the site still works, subdomain is reserved for you), day 44–104 "dormant" (scheduled cron functions pause, final warning 24h before deletion), day ~104 permanent deletion. Three warning emails. Any tier renewal during grace instantly reactivates the project and clears the countdown.

Which AI agents work with Run402?

Any agent with a shell can use the CLI; the typed SDK supports scripts and MCP supports tool-native hosts: Claude Code, ChatGPT, Cursor, Windsurf, Cline, OpenClaw, custom agents — anything. Run402 is also available as an MCP server (npx run402-mcp) and as an OpenClaw skill.

Can I use a custom domain?

Yes. Every site gets a *.run402.com subdomain by default, and you can attach your own domain (apex like example.com or any subdomain) through the CLI. Connecting a domain returns DNS instructions (a CNAME plus a TXT verification record); once DNS is verified, a TLS certificate is provisioned automatically and the domain serves your live site — including server-rendered functions, hosted auth, and edge caching. Verified custom domains can also send and receive email at your own addresses.

What database do I get?

PostgreSQL 16 on AWS Aurora Serverless v2. Each project gets its own schema with full SQL access. Row-level security is supported for multi-tenant apps. Backups are automated with 7-day retention.

Can I export my data?

Yes. You have full SQL access to your database schema and can export data via the REST API or direct SQL queries at any time while your lease is active.

What's the uptime?

Run402 runs on AWS multi-AZ infrastructure. Check current status at status.run402.com. We don't currently offer an SLA, but we aim for high availability.

Is my data secure?

Data is encrypted at rest (AES-256) and in transit (TLS 1.2+). Each project is isolated in its own PostgreSQL schema. See our Privacy Policy for full details.

What content is allowed on Run402?

See our Acceptable Use Policy in the Terms of Service. In short: no malware, phishing, illegal content, spam, or abuse. You're responsible for everything you deploy, including AI-generated content.

I'm not a developer. I just want to build stuff.

Check out bld402 — it's a free guided workflow that lets anyone build and deploy a web app without writing code. You describe what you want to your AI agent, and bld402 handles the rest. Run402 powers the infrastructure behind the scenes.