Integration guide

Prava domain-pay MCP

Mid-prompt domain purchase for coding agents. Add one URL to Cursor or Claude. No skill.md, no local secrets. Passkey approval stays in the browser.

Connect in one minute promptai.credit

live https://pravamcp.promptai.credit/mcp

1. Connect

Drop this into Cursor MCP settings, Claude custom connectors, or a project .cursor/mcp.json:

{
  "mcpServers": {
    "prava-promptai": {
      "url": "https://pravamcp.promptai.credit/mcp"
    }
  }
}

Then ask the agent something like:

Build a landing page for my side project and put it on flashship.dev.
Use the Prava MCP: check the domain, mint a payment session, wait for my
passkey approval, then register and finish shipping.

2. Tools

Tool	What it does
check_domain	Availability + 1y price. Returns the recommended Prava amount (min $10).
create_session	Mint a Prava payment session. Returns `iframe_url` for card + passkey.
poll_session	Poll until `pending` → `awaiting_result` (card ready).
report_status	Report `APPROVED` or `DECLINED` after registrar checkout.
register_domain	Namecheap sandbox `domains.create` (when configured on the host).

3. Canonical flow

check_domain — confirm the name is free and get the amount.
create_session — open the returned collect URL in Chrome/Safari.
Human enters card + OTP + passkey (you cannot skip this step).
poll_session until status is awaiting_result.
Drive registrar top-up / checkout with the one-time card.
report_status — APPROVED or DECLINED.
register_domain (sandbox) and finish shipping.

Sandbox tip. Namecheap's Stripe test account often declines Prava sandbox cards. That is expected. Report DECLINED, narrate it, then register on sandbox balance. Production settles with a real Visa network token.

Sandbox test card

Visa  4622 9431 2313 7789
CVV   757
Exp   12/27
OTP   456789

4. Health & ops

/healthz — liveness JSON
POST /mcp — Streamable HTTP MCP (JSON-RPC)
Secrets stay on the server. Callers never see Prava or registrar keys.
Rate limited. Public mode, no bearer token required.

5. Optional paths

Prefer this hosted MCP. If you need local scripts instead, see the agent-pay package and .cursor/skills/prava-domain-pay in the promptai repo. Official Prava MCP also exists at https://mcp.pay.prava.space/mcp.