run402-mcp

library2.37.0jsnpmunverified

MCP server for Run402, an AI-native Postgres database service that provides instant Postgres databases with REST API, authentication, storage, static site hosting, and serverless functions via x402 USDC micropayments. Currently at v2.37.0, actively maintained. Differentiator: pay-as-you-go with no cloud account required, integrated with MCP (Model Context Protocol) for AI agent use. Supports prototype (free testnet), hobby ($5/mo), and team ($20/mo) tiers. Ships TypeScript types, requires Node >=22.

database devops

npm install run402-mcp

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · RUN402-MCP

run402-mcp

databasejavascriptv2.37.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

run402-mcp

✓ npx -y run402-mcp

✗ npm install run402-mcp

Package is designed to be run via npx, not installed locally. The server is invoked directly by MCP clients.

provision_postgres_project

✓ import { provision_postgres_project } from 'run402-mcp' // not applicable; tools are invoked by MCP, not imported

✗ import { provisionPostgresProject } from 'run402-mcp'

Tools are not JavaScript exports; they are MCP tools named in snake_case. No direct import usage.

MCP Tools

✓ // Tools are invoked via MCP protocol; no code import needed

✗ import { run_sql, rest_query } from 'run402-mcp'

This is an MCP server, not a library. All interactions happen through the MCP transport (stdio).

Shows how to configure the MCP server in Claude Desktop and use its tools to create a Postgres database and run queries.

// Run402 MCP server is started via npx. Configuration is in your MCP client's settings. // Example for Claude Desktop (claude_desktop_config.json): // { // "mcpServers": { // "run402": { // "command": "npx", // "args": ["-y", "run402-mcp"] // } // } // } // After connecting, the LLM can call: // provision_postgres_project(tier: "prototype") // run_sql(project_id: "...", sql: "CREATE TABLE users (id SERIAL PRIMARY KEY, name TEXT)") // rest_query(project_id: "...", method: "POST", path: "/users", body: {"name": "Alice"})

Debug

Known issues

gotchaPackage is an MCP server; do not attempt to import it as a library. It is designed to be run via npx.

fix

Use the server via MCP transport (stdio). See documentation for client configuration.

affects: >=0.0.0

gotchaRequires Node >=22; older versions will fail to run.

fix

Update Node to version 22 or higher.

affects: >=2.0.0

deprecatedAPI base URL may change; check environment variable RUN402_API_BASE for custom endpoints.

fix

Set RUN402_API_BASE if using a custom or self-hosted backend.

affects: >=0.0.0

gotchaPayment is required for non-prototype tiers via x402 micropayments; the tool returns payment details instead of errors when payment is needed.

fix

Follow the payment flow provided by the tool output.

affects: >=0.0.0

breakingVersion 2.x dropped support for Node <22 and may have changed tool names or parameters from v1.x.

fix

Use Node >=22 and check that tool names match the documentation (snake_case).

affects: >=2.0.0

Errors

Common errors & fixes

Node.js v20 is not supported. Please use Node.js v22 or later.

The package requires Node >=22.

fix

Upgrade Node.js to version 22 or later.

Error: Cannot find module 'run402-mcp'

Trying to import or require the package as a module instead of using npx.

fix

Run via 'npx -y run402-mcp' instead of 'npm install' and require.

Error: connect ECONNREFUSED api.run402.com:443

Network connectivity issue or API endpoint is down.

fix

Check internet connection and verify API status at https://api.run402.com/health. If using a proxy, set RUN402_API_BASE.

Upgrade

Version history

2.37.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/kychee-com/run402 ↗

packagerun402-mcp ↗

homepagehttps://run402.com ↗