Guide

Cursor MCP setup

Paste the hosted MCP URL and your session token into Cursor. No repo clone required for production. Local stdio MCP remains available for developers.

1. Step 1

   Copy your session token

   Create an AI session in the dashboard and copy the MCP token (shown once). Use a token from the same environment you will call (production dashboard → production API).

2. Step 2

   Point Cursor at the hosted MCP URL

   Create or edit .cursor/mcp.json with the hosted config below — no repo clone or npm install required. Paste your token into the Authorization header.

3. Step 3

   Enable tools in Cursor

   Open Cursor Settings → Tools & MCP. Find pay3, toggle it on, and confirm get_balance, transfer, get_transaction_history, and get_swap_quote appear (execute_swap only if you enabled swap execute on the session). Reload the window if needed.

Hosted mcp.json (recommended)

File: .cursor/mcp.json (gitignored). Token must come from a session created against https://pay3-api.vercel.app.

{
  "mcpServers": {
    "pay3": {
      "url": "https://pay3-api.vercel.app/mcp",
      "headers": {
        "Authorization": "Bearer pay3_PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Local stdio (developers)

For local API work: npm run build:mcp then npm run dev:api.

{
  "mcpServers": {
    "pay3": {
      "command": "node",
      "args": ["${workspaceFolder}/apps/mcp-server/dist/index.js"],
      "env": {
        "PAY3_API_URL": "http://localhost:4000",
        "PAY3_MCP_TOKEN": "pay3_PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Example prompts

• “What’s my Pay3 balance?”
• “Pay 0.5 XLM to Hurain”
• “Pay 0.5 XLM to Debjit”
• “Pay 0.5 XLM to Manas”
• “Show my recent Pay3 transactions”
• “Quote swapping 1 XLM to USDC”

Lost your token?

Create a new session in the dashboard and copy the new token. Old tokens cannot be recovered — only a hash is stored.