@aurexcash/mcp-server

v2.1.13

Published

2 days ago

AI agent that pays with virtual cards via Aurex. MCP Server for Claude, Cursor, and any MCP client.

0High
0Medium
0Low

aurex

aurex mcp ai-agent virtual-cards solana payments claude cursor agentic-commerce

Aurex Cash Agent

AI agent that creates and manages virtual Visa/Mastercard cards via Aurex. Works with Claude Desktop, Cursor, and any MCP-compatible client.

Quick Start

npm install -g @aurexcash/mcp-server
aurex-agent setup
aurex-agent setup-mcp

Restart Claude Desktop, then ask:

"Check my Aurex balance"
"Create a $100 card called Amazon-March"
"Show my cards"
"Get card details for card_abc123"

How It Works

You:    "Create a $50 card for online shopping"
            |
            v
Claude calls aurex_create_card
            |
            v
Aurex API creates virtual Visa card
            |
            v
Claude: "Card created. Balance: $50. Use aurex_card_details to get the number."
            |
            v
You:    "Get the card details"
            |
            v
Claude calls aurex_card_details
            |
            v
Claude: "Number: 4111...1234, CVV: 123, Exp: 12/28"

Each user installs the agent locally with their own Aurex API credentials. No keys are stored on any server.

Setup

1. Get Aurex Credentials

2. Install and Configure

npm install -g @aurexcash/mcp-server
aurex-agent setup

Enter your API Key and User ID when prompted. Credentials are stored locally at ~/.aurex/config.json — never sent anywhere else.

3. Connect to Claude Desktop

aurex-agent setup-mcp

This automatically updates your claude_desktop_config.json. Restart Claude Desktop to activate.

Manual Config

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "aurex-cash": {
      "command": "npx",
      "args": ["-y", "@aurexcash/mcp-server"],
      "env": {
        "AUREX_API_KEY": "your_api_key",
        "AUREX_USER_ID": "your_user_id"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "aurex-cash": {
      "command": "npx",
      "args": ["-y", "@aurexcash/mcp-server"],
      "env": {
        "AUREX_API_KEY": "your_api_key",
        "AUREX_USER_ID": "your_user_id"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | aurex_balance | Check your Aurex wallet balance | | aurex_create_card | Create a new virtual card ($25 min) | | aurex_list_cards | List all cards with balances and statuses | | aurex_card_details | Get PAN, CVV, expiry for checkout | | aurex_topup_card | Add funds to an existing card | | aurex_card_transactions | View transaction history | | aurex_get_otp | Get 3DS verification code | | aurex_calculate_fees | Preview fees before creating a card |

Fees

| Action | Fee | |--------|-----| | Card creation | $19 + 5% of balance | | Top-up | 3% of amount | | Min card balance | $25 | | Max card balance | $100,000 |

Security

Your keys stay local — stored at ~/.aurex/config.json on your machine only
No server involved — the MCP agent runs as a local process, communicates directly with Aurex API over HTTPS
Card details on demand — PAN, CVV and expiry are only fetched when you explicitly ask
Zero telemetry — no analytics, no data sharing with third parties

Architecture

Your Machine
+---------------------------------------+
|  Claude Desktop / Cursor              |
|           | MCP (stdio)               |
|  @aurexcash/mcp-server (local)        |
|           | HTTPS                     |
|  aurex.cash API                       |
+---------------------------------------+

Railway (public info only)
  aurexcash-solana-agent.up.railway.app
  GET /        -> agent info
  GET /health  -> uptime check
  GET /install -> quickstart guide

The npm package runs locally on each user's machine with their own credentials. Railway hosts only a public info page — no API keys, no user data.

Requirements

Node.js 18+
Aurex account with API access — sign up at aurex.cash
Claude Desktop, Cursor, or any MCP-compatible client

License

MIT