Setup

Prerequisites

• Node.js >= 18

• An AstraPay API key from Settings → API Keys

---

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "astrapay": {
      "command": "npx",
      "args": ["-y", "astrapay-mcp"],
      "env": {
        "ASTRAPAY_API_KEY": "ap_live_your_api_key"
      }
    }
  }
}

Restart Claude Desktop. AstraPay tools will appear automatically.

---

Cursor

Create or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "astrapay": {
      "command": "npx",
      "args": ["-y", "astrapay-mcp"],
      "env": {
        "ASTRAPAY_API_KEY": "ap_live_your_api_key"
      }
    }
  }
}

---

VS Code

Edit .vscode/mcp.json:

{
  "servers": {
    "astrapay": {
      "command": "npx",
      "args": ["-y", "astrapay-mcp"],
      "env": {
        "ASTRAPAY_API_KEY": "ap_live_your_api_key"
      }
    }
  }
}

---

Environment variables

Variable	Required	Default	Description
ASTRAPAY_API_KEY	Yes	—	Your API key (ap_live_... or ap_test_...)
ASTRAPAY_API_URL	No	https://apipay.byastra.ai	Override API base URL
ASTRAPAY_API_PREFIX	No	/v1	API route prefix

Never commit your API key to version control. Use environment variables or a secrets manager.