Connect Your Agent

Connecting takes about a minute. You add the server URL to your MCP client, the client opens a browser window, and you sign in to approve. No API keys, no manual registration: the server supports automatic client registration (OAuth 2.1 dynamic client registration with PKCE), so any standard MCP client can connect itself.

Add the server

claude mcp add --transport http prava https://mcp.pay.prava.space/mcp

{
  "mcpServers": {
    "prava": {
      "url": "https://mcp.pay.prava.space/mcp"
    }
  }
}

Server URL:  https://mcp.pay.prava.space/mcp
Transport:   Streamable HTTP
Auth:        OAuth (automatic — the client discovers and registers itself)

Your client opens a browser window to Prava’s sign-in.
Sign in with your Prava Pay account (the same account as pay.prava.space; create one there if you’re new).
Review the requested scopes (payments:read, payments:write, checkout:run) and approve.
Done. The connection appears as an agent in your Prava Pay dashboard, alongside any CLI-linked agents.

Ask your agent to call the ping tool to confirm the connection.

First time with Prava? You’ll also add a card and a delivery address. Your agent can walk you through both: card entry happens on Prava’s secure page (via a payment_url), and addresses via the shop_add_address tool. The agent never sees the card.

Staying connected

Tokens refresh automatically. The client holds a refresh token; you won’t re-approve on every session.
Revoking access: revoke the agent in your Prava Pay dashboard. Its tokens stop working immediately.
Reconnecting: remove and re-add the server in your client, then sign in again.

Troubleshooting

Symptom	Cause	Fix
`401` / “Missing or malformed Authorization”	The client isn’t sending a bearer token	Re-run the OAuth flow (remove and re-add the server)
`403 insufficient_scope` on a tool call	The token lacks that tool’s scope	Reconnect and approve all requested scopes
”This token has no agent context”	The connection wasn’t fully approved	Reconnect; finish the sign-in and approval step
Tool calls fail after you revoked in the dashboard	Expected: revocation is immediate	Reconnect if it was a mistake

Still stuck? support@prava.space.

Tools reference

What each tool does and the order to call them in.

Your Prava Pay dashboard

Approvals, cards, spending controls, revocation.

Getting Started

Guides

Prava SDK

Prava MCP

Prava CLI

Resources

Add the server

Staying connected

Troubleshooting

Next

Tools reference

Your Prava Pay dashboard

​Add the server

​Sign in and approve

​Staying connected

​Troubleshooting

​Next

Tools reference

Your Prava Pay dashboard

Add the server

Sign in and approve

Staying connected

Troubleshooting

Next