@rackspay/mcp-server
v1.0.2
Published
RACKS MCP Server - Payment infrastructure for AI agents. Issue virtual cards, check budgets, and manage transactions via Claude Desktop or any MCP client.
Maintainers
Readme
RACKS MCP Server
Payment infrastructure for AI agents via Model Context Protocol.
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, create an agent, and copy your API key and agent ID.
2. Install
npm install -g @racks/mcp-serverOr run directly with npx:
npx @racks/mcp-server3. Configure Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"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 completeEach 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
# 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 buildAlso Available
- OpenClaw Skill: racks-payment skill for OpenClaw agents
- REST API: Direct integration via api.rackspay.com/docs
- Python SDK: Coming Q2 2026
- TypeScript SDK: Coming Q2 2026
Links
License
MIT — Racks AI, Inc.
