Give Your Claude Agent a Wallet

Connect Claude to Wallgent using MCP so your agent can create wallets, send payments, and manage finances with natural language.

Prerequisites

A Wallgent account and API key (get one here)
Claude Desktop or any MCP-compatible client

1. Add the MCP Server

Open your Claude Desktop configuration file:

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

Add the Wallgent MCP server:

{
  "mcpServers": {
    "wallgent": {
      "command": "npx",
      "args": ["-y", "@wallgent/mcp-server"],
      "env": {
        "WALLGENT_API_KEY": "wg_test_your_key_here"
      }
    }
  }
}

Save the file and restart Claude Desktop.

npx downloads and runs the server automatically — no install step needed. To pin a version, use @wallgent/mcp-server@0.1.0.

2. Verify the Connection

In a new Claude conversation, ask:

"What Wallgent tools do you have?"

Claude should list the available financial tools. If you see tools like wallgent_create_wallet, wallgent_send_payment, and wallgent_check_balance, the connection is working.

If Claude does not see the tools, check that:

The config file is valid JSON (no trailing commas)
You restarted Claude Desktop after editing the config
Your API key starts with wg_test_ or wg_live_

3. Complete Example

Here is a typical conversation flow with a Wallgent-connected Claude:

You: "Create a wallet called Research Agent and fund it with $200."

Claude will call:

{
  "name": "wallgent_create_wallet",
  "parameters": { "name": "Research Agent", "agentName": "research-bot" }
}

Then:

{
  "name": "wallgent_fund_wallet",
  "parameters": { "walletId": "wal_01J...", "amount": "200.00" }
}

You: "Send $15 to wal_01JVENDOR for the API subscription."

Claude will call:

{
  "name": "wallgent_send_payment",
  "parameters": {
    "fromWalletId": "wal_01J...",
    "toWalletId": "wal_01JVENDOR",
    "amount": "15.00",
    "description": "API subscription"
  }
}

You: "What's my balance and recent transactions?"

Claude will call wallgent_check_balance and wallgent_get_transactions, then summarize the results in natural language.

Available Tools

The MCP server exposes 58 tools grouped by category:

Wallet Management (9 tools)

Tool	Description
`wallgent_create_wallet`	Create a new wallet
`wallgent_get_wallet`	Get wallet details
`wallgent_list_wallets`	List all wallets
`wallgent_check_balance`	Check wallet balance
`wallgent_fund_wallet`	Fund a wallet
`wallgent_freeze_wallet`	Freeze a wallet
`wallgent_unfreeze_wallet`	Unfreeze a wallet
`wallgent_deposit_wallet`	Deposit via external rail
`wallgent_withdraw_wallet`	Withdraw to external destination

Payments (3 tools)

Tool	Description
`wallgent_send_payment`	Send a payment between wallets
`wallgent_batch_payment`	Send multiple payments at once
`wallgent_get_transactions`	Get wallet transaction history

Transfers (1 tool)

Tool	Description
`wallgent_get_transfer`	Check deposit/withdrawal status

Policies (1 tool)

Tool	Description
`wallgent_get_policies`	List wallet spending policies

Approvals (3 tools)

Tool	Description
`wallgent_list_approvals`	List pending approvals
`wallgent_approve_payment`	Approve a pending payment
`wallgent_reject_payment`	Reject a pending payment

Delegations (2 tools)

Tool	Description
`wallgent_list_delegations`	List wallet delegations
`wallgent_create_delegation`	Grant wallet access to another org

Cards (4 tools)

Tool	Description
`wallgent_create_card`	Create a virtual card
`wallgent_list_cards`	List virtual cards
`wallgent_freeze_card`	Freeze a card
`wallgent_unfreeze_card`	Unfreeze a card

Payment Links (3 tools)

Tool	Description
`wallgent_create_payment_link`	Create a payment link
`wallgent_list_payment_links`	List payment links
`wallgent_cancel_payment_link`	Cancel a payment link

Customers (2 tools)

Tool	Description
`wallgent_create_customer`	Create a customer for billing
`wallgent_list_customers`	List customers

Invoices (6 tools)

Tool	Description
`wallgent_create_invoice`	Create an invoice
`wallgent_list_invoices`	List invoices
`wallgent_finalize_invoice`	Finalize a draft invoice
`wallgent_charge_customer`	Charge a saved payment method
`wallgent_void_invoice`	Void an unpaid invoice
`wallgent_refund_invoice`	Refund a paid invoice

Compliance (2 tools)

Tool	Description
`wallgent_compliance_status`	PCI-DSS compliance status
`wallgent_compliance_evidence`	Audit evidence summary

Agent Network (2 tools)

Tool	Description
`wallgent_pay_agent`	Pay another agent by Wallgent address
`wallgent_search_directory`	Search the agent directory

See the MCP Tools Reference for full parameter details on every tool.

Self-Hosted Server

If you prefer to run the server from source instead of npx:

{
  "mcpServers": {
    "wallgent": {
      "command": "node",
      "args": ["path/to/wallgent/apps/mcp-server/dist/index.js"],
      "env": {
        "WALLGENT_API_KEY": "wg_test_your_key_here",
        "WALLGENT_BASE_URL": "http://localhost:3000",
        "TRANSPORT": "stdio"
      }
    }
  }
}

See the MCP Guide for HTTP transport and advanced configuration.

Next Steps

Set up spending policies to control your agent's budget
Add webhooks to get notified when payments happen
Explore the full SDK Reference for server-side integration

Give Your Claude Agent a Wallet

On this page