Clawallex Mcp

clawallex/clawallex-mcp

Connects Claude to the Clawallex payment API for creating USDC-backed virtual cards that work at any online checkout. Exposes wallet balance checks, one-time card creation via clawallex_pay, recurring subscription cards with clawallex_subscribe, and card refills. Each card gets encrypted PAN/CVV details you can decrypt and use programmatically. Handles agent identity binding through client_id so your cards stay isolated even if you rotate API keys. Built for agents that need to autonomously pay for API credits, cloud subscriptions, or any merchant that takes cards. Includes transaction history, MCC controls, and x402 on-chain payment support for advanced flows.

tools: 14
auth: Secret needed
transport: STDIO
env vars: 2
last updated: Mar 30, 2026

View on GitHub

Tools

14 tools

Public tool metadata for what this MCP can expose to an agent.

batch_card_balancesCheck balances for multiple cards in one call.1 params

Check balances for multiple cards in one call.

Parameters* required

card_idsarray

Array of card IDs

clawallex_payPay for a product or service using USDC. Creates a single-use flash virtual card (card_type=100), deducts from wallet balance, returns card details for checkout. Mode A (mode_code=100, default): wallet balance → flash card. Immediate settlement. Mode B (mode_code=200): for cal...15 params

Pay for a product or service using USDC. Creates a single-use flash virtual card (card_type=100), deducts from wallet balance, returns card details for checkout. Mode A (mode_code=100, default): wallet balance → flash card. Immediate settlement. Mode B (mode_code=200): for cal...

Parameters* required

allowed_mccstring

MCC whitelist, comma-separated. Mutually exclusive with blocked_mcc (optional)

amountnumber

Card face amount in USD

blocked_mccstring

MCC blacklist, comma-separated. Mutually exclusive with allowed_mcc (optional)

chain_codestring

Chain code for Mode B Stage 1 (e.g. 'ETH')

client_request_idstring

UUID idempotency key. Mode B Stage 2: MUST reuse from Stage 1.

descriptionstring

What this payment is for

extraobject

Mode B Stage 2 (required): { card_amount, paid_amount }

mode_codeinteger

Payment mode: wallet balance (100, default) or x402 on-chain (200)

payer_addressstring

Payer wallet address (optional)

payment_payloadobject

x402 payment payload (Mode B Stage 2, required)

payment_requirementsobject

x402 payment requirements (Mode B Stage 2, required)

token_codestring

Token code for Mode B Stage 1 (e.g. 'USDC')

tx_limitstring

Per-transaction limit in USD (optional)

x402_reference_idstring

x402 reference ID (Stage 2: from 402 response)

x402_versioninteger

x402 version (Mode B Stage 2, required)

clawallex_refillTop up the balance of a subscription (stream) card. Only stream cards (card_type=200) can be refilled. Refill mode follows the card's creation mode. Mode A: deducts from wallet balance. client_request_id is the idempotency key (auto-generated if omitted). Mode B: x402 settle (...8 params

Top up the balance of a subscription (stream) card. Only stream cards (card_type=200) can be refilled. Refill mode follows the card's creation mode. Mode A: deducts from wallet balance. client_request_id is the idempotency key (auto-generated if omitted). Mode B: x402 settle (...

Parameters* required

amountnumber

Refill amount in USD

card_idstring

Stream card ID to refill

client_request_idstring

Mode A idempotency key (auto-generated if omitted)

payer_addressstring

Payer wallet address (optional)

payment_payloadobject

x402 payment payload (Mode B, required)

payment_requirementsobject

x402 payment requirements (Mode B, required)

x402_reference_idstring

x402 reference ID for Mode B

x402_versioninteger

x402 version (Mode B, required)

clawallex_subscribeSet up a reloadable virtual card for recurring/subscription payments. Creates a stream card (card_type=200) that stays active and can be refilled via clawallex_refill. Mode A (mode_code=100, default): wallet balance → stream card. Immediate settlement. Mode B (mode_code=200):...15 params

Set up a reloadable virtual card for recurring/subscription payments. Creates a stream card (card_type=200) that stays active and can be refilled via clawallex_refill. Mode A (mode_code=100, default): wallet balance → stream card. Immediate settlement. Mode B (mode_code=200):...

Parameters* required

allowed_mccstring

MCC whitelist, comma-separated. Mutually exclusive with blocked_mcc (optional)

blocked_mccstring

MCC blacklist, comma-separated. Mutually exclusive with allowed_mcc (optional)

chain_codestring

Chain code for Mode B Stage 1 (e.g. 'ETH')

client_request_idstring

UUID idempotency key. Mode B Stage 2: MUST reuse from Stage 1.

descriptionstring

Subscription purpose

extraobject

Mode B Stage 2: { card_amount, paid_amount }

initial_amountnumber

Initial deposit in USD

mode_codeinteger

Payment mode: wallet balance (100, default) or x402 on-chain (200)

payer_addressstring

Payer wallet address (optional)

payment_payloadobject

x402 payment payload (Mode B Stage 2)

payment_requirementsobject

x402 payment requirements (Mode B Stage 2)

token_codestring

Token code for Mode B Stage 1 (e.g. 'USDC')

tx_limitstring

Per-transaction limit in USD (optional)

x402_reference_idstring

x402 reference ID

x402_versioninteger

x402 version (Mode B Stage 2)

create_card_orderAdvanced: create a virtual card with full control over payment mode and card type. Most agents should use clawallex_pay or clawallex_subscribe instead. Mode A (mode_code=100): wallet balance deduction, immediate settlement. Mode B (mode_code=200): for callers with self-custody...16 params

Advanced: create a virtual card with full control over payment mode and card type. Most agents should use clawallex_pay or clawallex_subscribe instead. Mode A (mode_code=100): wallet balance deduction, immediate settlement. Mode B (mode_code=200): for callers with self-custody...

Parameters* required

allowed_mccstring

MCC whitelist, comma-separated. Mutually exclusive with blocked_mcc (optional)

amountstring

Card face amount in USD, decimal string e.g. '100.0000'

blocked_mccstring

MCC blacklist, comma-separated. Mutually exclusive with allowed_mcc (optional)

card_typeinteger

Card type: 100=flash (single-use), 200=stream (reloadable)

chain_codestring

Chain code for Mode B Stage 1 (e.g. 'ETH', 'BASE')

client_request_idstring

UUID idempotency key — MUST be same for Stage 1 and Stage 2

extraobject

Mode B Stage 2: { card_amount, paid_amount }

fee_amountstring

Fee amount in USD (optional)

mode_codeinteger

Payment mode: 100=Mode A (wallet balance), 200=Mode B (x402 on-chain USDC)

payer_addressstring

Payer wallet address (optional)

payment_payloadobject

x402 payment payload (Mode B Stage 2, required)

payment_requirementsobject

x402 payment requirements (Mode B Stage 2, required)

token_codestring

Token code for Mode B Stage 1 (e.g. 'USDC')

tx_limitstring

Per-transaction limit in USD (optional)

x402_reference_idstring

x402 reference ID (Stage 2: from 402 response)

x402_versioninteger

x402 version (Mode B Stage 2, required)

get_card_balanceGet the current balance and status of a virtual card. Returns available_balance, card_currency, status, and updated_at.1 params

Get the current balance and status of a virtual card. Returns available_balance, card_currency, status, and updated_at.

Parameters* required

card_idstring

Card ID, e.g. 'c_123'

get_card_detailsGet full card details including PAN, CVV, expiry, balance, cardholder info, billing address, and risk controls.1 params

Get full card details including PAN, CVV, expiry, balance, cardholder info, billing address, and risk controls.

Parameters* required

card_idstring

Card ID, e.g. 'c_123'

get_walletGet the wallet details for the current API key. Each API key has exactly one wallet — shared across all agents using the same API key. Returns available_balance, frozen_balance, low_balance_threshold, currency (USD), and status. Use this to check if there is sufficient balance...

Get the wallet details for the current API key. Each API key has exactly one wallet — shared across all agents using the same API key. Returns available_balance, frozen_balance, low_balance_threshold, currency (USD), and status. Use this to check if there is sufficient balance...

No parameter schema in public metadata yet.

get_wallet_recharge_addressesGet the on-chain deposit addresses for a wallet. Send USDC to one of these addresses to top up the wallet balance. If the result is empty, no deposit address has been created yet — ask the user to visit https://app.clawallex.com to create one.1 params

Get the on-chain deposit addresses for a wallet. Send USDC to one of these addresses to top up the wallet balance. If the result is empty, no deposit address has been created yet — ask the user to visit https://app.clawallex.com to create one.

Parameters* required

wallet_idstring

Wallet ID returned by get_wallet, e.g. 'w_123'

get_x402_payee_addressGet the system receiving address for x402 on-chain payments. When to use: MUST call this before Mode B Refill to obtain payee_address and asset_address. Not needed for Mode B card creation — the 402 quote response already includes both addresses. Returns: payee_address (paymen...2 params

Get the system receiving address for x402 on-chain payments. When to use: MUST call this before Mode B Refill to obtain payee_address and asset_address. Not needed for Mode B card creation — the 402 quote response already includes both addresses. Returns: payee_address (paymen...

Parameters* required

chain_codestring

Chain code, e.g. 'ETH', 'BASE'

token_codestring

Token code, e.g. 'USDC'

list_cardsList virtual cards created by this agent (scoped to the server's client_id). Cards created by other agents using the same API key are not visible. Returns: card_id, mode_code, card_type (flash/stream), status, masked PAN, balance, and expiry.2 params

List virtual cards created by this agent (scoped to the server's client_id). Cards created by other agents using the same API key are not visible. Returns: card_id, mode_code, card_type (flash/stream), status, masked PAN, balance, and expiry.

Parameters* required

pageinteger

Page number, starting from 1 (default 1)

page_sizeinteger

Results per page, max 100 (default 20)

list_transactionsList card transactions for this agent (scoped to the server's client_id). Transactions from other agents using the same API key are not visible. All filter parameters are optional — omit all to list recent transactions across all cards.5 params

List card transactions for this agent (scoped to the server's client_id). Transactions from other agents using the same API key are not visible. All filter parameters are optional — omit all to list recent transactions across all cards.

Parameters* required

card_idstring

Filter by card ID to get transactions for one card

card_tx_idstring

Filter by platform transaction ID (e.g. 'ctx_123')

issuer_tx_idstring

Filter by issuer transaction ID

pageinteger

Page number, starting from 1 (default 1)

page_sizeinteger

Results per page, max 100 (default 20)

update_cardUpdate card risk controls: per-transaction limit and MCC whitelist/blacklist. At least one field must be provided.5 params

Update card risk controls: per-transaction limit and MCC whitelist/blacklist. At least one field must be provided.

Parameters* required

allowed_mccstring

MCC whitelist, comma-separated. Mutually exclusive with blocked_mcc (optional)

blocked_mccstring

MCC blacklist, comma-separated. Mutually exclusive with allowed_mcc (optional)

card_idstring

Card ID to update

client_request_idstring

UUID idempotency key

tx_limitstring

Per-transaction limit in USD (optional)

whoamiQuery the current MCP connection status. Returns user_id, api_key_id, and client_id bound to this MCP token.

Query the current MCP connection status. Returns user_id, api_key_id, and client_id bound to this MCP token.

No parameter schema in public metadata yet.

Configuration

CLAWALLEX_API_KEY*secret

Clawallex API Key

CLAWALLEX_API_SECRET*secret

Clawallex API Secret for HMAC-SHA256 signing

Readme

@clawallex/mcp-server

MCP Server for the Clawallex payment API. Pay for anything with USDC — Clawallex converts your stablecoin balance into virtual cards that work at any online checkout.

Quick Start

1. Install

npm install -g @clawallex/mcp-server

Or use directly via npx (no install needed).

2. Get API Credentials

3. Configure Your AI Client

Choose your client and add the configuration:

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "clawallex": {
      "command": "npx",
      "args": ["@clawallex/mcp-server"],
      "env": {
        "CLAWALLEX_API_KEY": "your_api_key",
        "CLAWALLEX_API_SECRET": "your_api_secret"
      }
    }
  }
}

Claude Code

claude mcp add --scope local clawallex -- npx @clawallex/mcp-server \
  --api-key your_api_key \
  --api-secret your_api_secret

Codex CLI

Add to your ~/.codex/config.toml or .codex/config.toml:

View the full README on GitHub

Details

Repository: github.com/clawallex/clawallex-mcp
Category: Finance & Commerce
Package: @clawallex/mcp-server
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Finance & Commerce MCP servers

View all

True Markets Market Dataco.truemarkets/marketdataReal-time crypto market data0stars

AdCritter for Builderscom.adcritter/mcp-devAdCritter ads platform: docs, API reference, app scaffolding, and white-label integration.0stars

Agentoristcom.agentorist/agentoristBooking gateway for AI agents — discover events, movies & hotels, hand off to partner checkout.0stars

Bankruptcy Observerjmtroller/mcp-documentationUS business bankruptcy MCP: filings, dockets, documents, case summaries. Free tier + subscription.0stars

Cryptohopper Market Datacom.cryptohopper/mcp-dataReal-time crypto market data: candles, tickers, orderbooks across 13+ exchanges via MCP.0stars

Maximum Satsjoelklabo/maximumsats-mcpBitcoin AI + Nostr WoT scoring (12 tools). L402 pay-per-call. 50 free WoT/day.0stars