Skip to content

run402-mcp

MCP server for Run402 — AI-native Postgres databases with REST API, auth, storage, and row-level security. Pay with x402 USDC micropayments.

2,645
Weekly Downloads
build.protocol_tooling.mcp#mcp#model-context-protocol#postgres#database#ai#agent#run402#x402#supabase-alternative#backend-as-a-service

Install run402-mcp in your MCP client

run402-mcp is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add run402-mcp to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; run402-mcp's tools should appear.
{
  "mcpServers": {
    "run402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "run402-mcp"
      ]
    }
  }
}

Install run402-mcp in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. run402-mcp will show up in the assistant's tool list on next launch.

Install run402-mcp in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). run402-mcp will show up in the assistant's tool list on next launch.

Install run402-mcp in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). run402-mcp will show up in the assistant's tool list on next launch.

Install run402-mcp in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. run402-mcp will show up in the assistant's tool list on next launch.

npm package: run402-mcp

Transport

run402-mcp supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdio

From the run402-mcp README

# run402-mcp [Run402](https://run402.com) 的 MCP 服务器 — 从任何 MCP 兼容客户端创建和管理 AI 原生 Postgres 数据库。 > **免费试用 7 天完整后端(测试网)。进阶/团队版可用 USDC 或 Stripe 支付。** > 数据库 + REST API + 鉴权 + 存储 + 静态站点 + 函数。无需云账号。 [English](./README.md) | 简体中文 ## 快速开始 ```bash npx run402-mcp ``` ## 工具列表 | 工具 | 说明 | |------|------| | `provision_postgres_project` | 创建新的 Postgres 数据库(prototype/hobby/team 等级) | | `run_sql` | 对项目执行 SQL(DDL 或查询) | | `rest_query` | 通过 PostgREST 查询/修改数据 | | `renew_project` | 续期数据库租约 | | `deploy_site` | 部署静态 HTML/CSS/JS 站点 | | `deploy_function` | 部署 Node 22 Serverless 函数 | | `invoke_function` | 调用已部署的函数 | | `get_function_logs` | 获取函数日志,可按 `since` 和 routed `request_id` 过滤 | | `set_secret` | 设置函数环境变量 | ## 定价 | 等级 | 价格 | 租期 | 存储 | API 调用 | |------|------|------|------|----------| | Prototype 原型 | 免费(

Other Model Context Protocol servers in the same space as run402-mcp. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.