npm package: @rackspay/mcp-server
Description: RACKS MCP Server - Payment infrastructure for AI agents. Issue virtual cards, check budgets, and manage transactions via Claude Desktop or any MCP client.
Author: Racks AI, Inc.
Latest version: 1.0.2

# RACKS MCP Server

Payment infrastructure for AI agents via [Model Context Protocol](https://modelcontextprotocol.io).

Issue single-use virtual cards, check budgets, view transactions, and validate purchases — all from Claude Desktop or any MCP-compatible client.

## Quick Start

### 1. Get Your Credentials

Sign up at [rackspay.com/dashboard](https://rackspay.com/dashboard), create an agent, and copy your API key and agent ID.

### 2. Install

```bash
npm install -g @racks/mcp-server
```

Or run directly with npx:

```bash
npx @racks/mcp-server
```

### 3. Configure Claude Desktop

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

```json
{
  "mcpServers": {
    "racks-payment": {
      "command": "npx",
      "args": ["-y", "@racks/mcp-server"],
      "env": {
        "RACKS_AGENT_API_KEY": "your-api-key-here",
        "RACKS_AGENT_ID": "your-agent-id-here"
      }
    }
  }
}
```

Restart Claude Desktop. You should see the RACKS tools available in the tools menu.

### 4. Try It

Ask Claude:

- "Check my RACKS budget"
- "Buy a domain on Namecheap for myproject.com if it's under $15"
- "Show me my recent transactions"

## Available Tools

| Tool | Description |
|------|-------------|
| `racks_issue_card` | Request a single-use virtual card for a purchase |
| `racks_check_budget` | Check current spend and remaining balance |
| `racks_get_transactions` | View transaction history |
| `racks_validate_transaction` | Pre-validate a purchase without issuing a card |

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `RACKS_AGENT_API_KEY` | Yes | Your agent's API key from the dashboard |
| `RACKS_AGENT_ID` | Yes | Your agent's UUID from the dashboard |
| `RACKS_API_URL` | No | API endpoint (default: `https://api.rackspay.com`) |

## How It Works

```
Claude Desktop (MCP Client)
    ↓ [tool call: racks_issue_card]
RACKS MCP Server (this package)
    ↓ [POST /api/v1/agent/cards/request]
RACKS API (api.rackspay.com)
    ↓ [Budget validation → Card issuance]
Stripe Issuing
    ↓ [Virtual card details]
Claude receives card → fills payment form → purchase complete
```

Each card is single-use and self-destructs after the transaction. Budget limits are enforced in real-time. Every transaction is logged with a full audit trail.

## Development

```bash
# Clone and install
git clone https://github.com/racks-ai/racks-mcp-server.git
cd racks-mcp-server
npm install

# Run in development mode
RACKS_AGENT_API_KEY=your-key RACKS_AGENT_ID=your-id npm run dev

# Build for production
npm run build
```

## Also Available

- **OpenClaw Skill**: [racks-payment skill](https://rackspay.com/docs/integrations/openclaw) for OpenClaw agents
- **REST API**: Direct integration via [api.rackspay.com/docs](https://api.rackspay.com/docs)
- **Python SDK**: Coming Q2 2026
- **TypeScript SDK**: Coming Q2 2026

## Links

- [RACKS Documentation](https://rackspay.com/docs)
- [API Reference](https://api.rackspay.com/docs)
- [Dashboard](https://rackspay.com/dashboard)
- [MCP Protocol](https://modelcontextprotocol.io)

## License

MIT — Racks AI, Inc.