# Run402

Lets an agent spin up Postgres, auth, files, functions and hosting on its own. Usage is paid per call with x402 or MPP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 24
- Author: kychee-com
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kychee-com/run402
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/run402

## What it does

Run402 is an open backend that speaks to a machine rather than a person. Through MCP tools an agent sets up a Postgres database, user auth, content-addressed storage and serverless functions, then ships the whole thing in one staged deploy. No dashboard login is needed to begin, and there is no API key to copy by hand.

Billing works from a wallet: x402 with USDC on Base, MPP with pathUSD on Tempo, or sats over Bitcoin Lightning. A card-funded allowance is another route. The prototype tier is free on testnet, which is a sensible place to find out whether the workflow fits you. Each MCP tool is a thin wrapper over a call in `@run402/sdk`; the same operations exist in the CLI and in TypeScript.

The remote endpoint at `https://mcp.run402.com/mcp` runs over HTTP. If you start the server locally with `npx -y run402-mcp`, set `RUN402_WALLET` — skip it and the agent has nothing to pay with, so payment fails. The MCP surface is narrower than the CLI: for scripts and CI, reach for `run402` on the command line. Tool output arrives trimmed, and `expand_result` opens the detail behind it.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.run402.com/mcp`
- Environment variables: `RUN402_WALLET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.run402.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env RUN402_WALLET=<RUN402_WALLET> --transport stdio run402 -- npx -y run402-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add run402 --url https://mcp.run402.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add run402 --env RUN402_WALLET=<RUN402_WALLET> -- npx -y run402-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "run402": {
            "url": "https://mcp.run402.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "run402": {
            "command": "npx",
            "args": [
                "-y",
                "run402-mcp"
            ],
            "env": {
                "RUN402_WALLET": "<RUN402_WALLET>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "run402": {
            "type": "http",
            "url": "https://mcp.run402.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "run402": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "run402-mcp"
            ],
            "env": {
                "RUN402_WALLET": "<RUN402_WALLET>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http run402 https://mcp.run402.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e RUN402_WALLET=<RUN402_WALLET> run402 npx -y run402-mcp
```
Replace <…> with your own values

## When to use it
- provision a Postgres database and REST API from the agent
- pay for service calls straight from an agent wallet
- ship a static site and functions with staged deploys
- attach content-addressed file storage to a project
- re-verify an app over HTTP without a fresh deploy

## Example prompts
- Bootstrap a run402 project named `my-app` and deploy this folder
- List the run402 functions deployed in this project
- Re-check the app's HTTP responses on staging

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md