astrapay-mcp

MCP (Model Context Protocol) server for the AstraPay crypto payment API. Lets AI agents — Claude, ChatGPT, Cursor, Copilot, and others — create payments, manage products, and configure webhooks through natural language.

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor

Add to .cursor/mcp.json:

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

VS Code

Add to .vscode/mcp.json:

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

Tools

Payments

| Tool | Description | |------|-------------| | create_payment | Create a crypto payment, returns checkout URL | | get_payment | Get payment status by ID | | list_payments | List payments with optional status filter | | cancel_payment | Cancel a pending payment |

Products

| Tool | Description | |------|-------------| | create_product | Create a product with price | | list_products | List all products | | update_product | Update a product | | delete_product | Delete a product |

Webhooks

| Tool | Description | |------|-------------| | create_webhook | Register a webhook URL for payment events | | get_webhook | Get webhook details by ID | | list_webhooks | List registered webhooks | | update_webhook | Update a webhook's URL, events, or status | | delete_webhook | Delete a webhook |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | ASTRAPAY_API_KEY | Yes | — | Your AstraPay API key | | ASTRAPAY_API_URL | No | https://apipay.byastra.ai | API base URL | | ASTRAPAY_API_PREFIX | No | /v1 | API route prefix |

Example Prompts

Once connected, you can say things like:

• "Create a $25 USDC payment on Base for [email protected]"
• "List all pending payments"
• "Create a product called 'Pro Plan' for $49"
• "Set up a webhook at https://example.com/hooks for payment completions"
• "Cancel payment abc123"

API Key Scopes

Your API key needs these scopes:

• payments:create — create and cancel payments
• payments:read — list and get payments
• products:manage — CRUD products
• webhooks:manage — CRUD webhooks

Generate an API key at pay.byastra.ai/settings → API Keys.

Development

cd packages/mcp
yarn install
yarn build

Test locally:

ASTRAPAY_API_KEY=test_key node build/index.js