Wallgent

MCP Tools Reference

Complete reference for all 58 MCP tools available to AI agents.

Overview

The Wallgent MCP server exposes 58 tools that AI agents can use to manage finances through the Model Context Protocol. These tools wrap the Wallgent REST API, so agents don't need to construct HTTP requests.

See the MCP Guide for setup instructions.

Wallet Management (9 tools)

wallgent_create_wallet

Create a new Wallgent wallet for an AI agent.

ParameterTypeRequiredDescription
namestringYesWallet name
agentNamestringNoAgent identifier

wallgent_get_wallet

Get details for a specific Wallgent wallet including balance, name, and environment.

ParameterTypeRequiredDescription
walletIdstringYesWallet ID

wallgent_list_wallets

List all wallets accessible with the current API key.

No parameters required.

wallgent_check_balance

Check the balance of a Wallgent wallet.

ParameterTypeRequiredDescription
walletIdstringYesWallet ID

wallgent_fund_wallet

Fund a Wallgent wallet with a specified amount.

ParameterTypeRequiredDescription
walletIdstringYesWallet ID
amountstringYesAmount to fund

wallgent_freeze_wallet

Freeze a wallet to prevent any outgoing payments or funding. Balance reads remain available.

ParameterTypeRequiredDescription
walletIdstringYesWallet ID

wallgent_unfreeze_wallet

Unfreeze a previously frozen wallet, re-enabling payments and funding.

ParameterTypeRequiredDescription
walletIdstringYesWallet ID

wallgent_deposit_wallet

Deposit funds into a wallet via an external rail (ACH, wire, FedNow, or USDC).

ParameterTypeRequiredDescription
walletIdstringYesWallet ID
amountstringYesAmount to deposit
currencystringYesUSD or USDC
bankAccountIdstringNoLinked bank account ID

wallgent_withdraw_wallet

Withdraw funds from a wallet to an external destination (ACH, wire, FedNow, or USDC).

ParameterTypeRequiredDescription
walletIdstringYesWallet ID
amountstringYesAmount to withdraw
currencystringYesUSD or USDC
bankAccountIdstringNoLinked bank account ID

Payments (3 tools)

wallgent_send_payment

Send a payment between Wallgent wallets.

ParameterTypeRequiredDescription
fromWalletIdstringYesSource wallet ID
toWalletIdstringYesDestination wallet ID
amountstringYesPayment amount
descriptionstringNoPayment description

wallgent_batch_payment

Send multiple payments in a single batch. Each payment succeeds or fails independently (partial success is possible).

ParameterTypeRequiredDescription
paymentsarrayYesArray of payment objects

wallgent_get_transactions

Get recent transactions for a Wallgent wallet.

ParameterTypeRequiredDescription
walletIdstringYesWallet ID
limitnumberNoNumber of transactions

Transfers (2 tools)

wallgent_get_transfer

Get the status of a deposit or withdrawal transfer.

ParameterTypeRequiredDescription
transferIdstringYesTransfer ID

wallgent_list_transfers

List external rail transfers (deposits and withdrawals) for the organization, with optional filters.

ParameterTypeRequiredDescription
walletIdstringNoFilter by wallet ID
directionstringNoDEPOSIT or WITHDRAWAL
statusstringNoFilter by status (PENDING, COMPLETED, FAILED, etc.)
limitnumberNoNumber of results (max 100)

Policies (4 tools)

wallgent_get_policies

Get spending policies for a Wallgent wallet.

ParameterTypeRequiredDescription
walletIdstringYesWallet ID

wallgent_create_policy

Create a spending policy for a wallet to control when and how funds can be used.

ParameterTypeRequiredDescription
walletIdstringYesThe wallet to attach the policy to
namestringYesA descriptive name for the policy
maxTransactionAmountstringNoMaximum amount per transaction (e.g. "100.00")
dailySpendingLimitstringNoMaximum total spend per day (e.g. "500.00")
requireHumanApprovalbooleanNoRequire human approval for all transactions
approvedRecipientsstring[]NoAllowlist of wallet IDs or addresses

wallgent_update_policy

Update an existing spending policy on a wallet.

ParameterTypeRequiredDescription
walletIdstringYesThe wallet that owns the policy
policyIdstringYesThe ID of the policy to update
namestringNoNew name for the policy
enabledbooleanNoEnable or disable the policy
maxTransactionAmountstring | nullNoNew max transaction amount (null to remove)
dailySpendingLimitstring | nullNoNew daily spending limit (null to remove)
requireHumanApprovalbooleanNoToggle human approval requirement

wallgent_delete_policy

Delete a spending policy from a wallet.

ParameterTypeRequiredDescription
walletIdstringYesThe wallet that owns the policy
policyIdstringYesThe ID of the policy to delete

Approvals (3 tools)

wallgent_list_approvals

List pending payment approvals that require human review before execution.

No parameters required.

wallgent_approve_payment

Approve a pending payment that requires human approval. The payment will be executed immediately.

ParameterTypeRequiredDescription
approvalIdstringYesApproval ID

wallgent_reject_payment

Reject a pending payment that requires human approval. The payment will not be executed.

ParameterTypeRequiredDescription
approvalIdstringYesApproval ID
reasonstringNoRejection reason

Delegations (2 tools)

wallgent_list_delegations

List all wallet delegations granted by or to this organization.

No parameters required.

wallgent_create_delegation

Delegate wallet access to another organization with specific permissions.

ParameterTypeRequiredDescription
granteeOrgIdstringYesOrganization to grant access
walletIdstringYesWallet to delegate
permissionsstring[]YesPermissions to grant
expiresAtstringNoExpiry date (ISO 8601)

Cards (4 tools)

wallgent_create_card

Create a virtual card (persistent or single-use) linked to a Wallgent wallet. Returns card number and CVC for immediate use.

ParameterTypeRequiredDescription
walletIdstringYesWallet to link the card to
typestringYesPERSISTENT or SINGLE_USE

wallgent_list_cards

List virtual cards, optionally filtered by wallet ID.

ParameterTypeRequiredDescription
walletIdstringNoFilter by wallet

wallgent_freeze_card

Freeze a virtual card to temporarily prevent spending.

ParameterTypeRequiredDescription
cardIdstringYesCard ID

wallgent_unfreeze_card

Unfreeze a virtual card to resume spending.

ParameterTypeRequiredDescription
cardIdstringYesCard ID

Create a payment link to send money to anyone. Returns a URL that recipients can use to claim the funds via bank transfer, USDC, or another Wallgent wallet.

ParameterTypeRequiredDescription
walletIdstringYesFunding wallet
amountstringYesAmount to send
descriptionstringNoLink description

List payment links with optional filters.

ParameterTypeRequiredDescription
walletIdstringNoFilter by wallet
statusstringNoFilter by status

Cancel a pending payment link and release held funds back to the wallet.

ParameterTypeRequiredDescription
paymentLinkIdstringYesPayment link ID

Customers (2 tools)

wallgent_create_customer

Create a customer record for billing. Saves their info so you can send invoices and charge their saved payment method later.

ParameterTypeRequiredDescription
emailstringYesCustomer email
namestringYesCustomer name

wallgent_list_customers

List all customers you have created for billing.

No parameters required.

Invoices (6 tools)

wallgent_create_invoice

Create an invoice for a customer. Optionally finalize it immediately to get a payment link. Funds settle into your wallet when paid.

ParameterTypeRequiredDescription
walletIdstringYesReceiving wallet
customerIdstringYesCustomer to bill
lineItemsarrayYesLine items
memostringNoInvoice memo

wallgent_list_invoices

List invoices with optional filters by wallet, customer, or status.

ParameterTypeRequiredDescription
walletIdstringNoFilter by wallet
customerIdstringNoFilter by customer
statusstringNoFilter by status

wallgent_finalize_invoice

Finalize a draft invoice so it can be paid. Returns a checkout URL you can send to the customer.

ParameterTypeRequiredDescription
invoiceIdstringYesInvoice ID

wallgent_charge_customer

Charge a customer's saved payment method for work completed. Creates an invoice, charges the card, and deposits funds into your wallet in one step. Optionally set recurring to auto-charge on a schedule.

ParameterTypeRequiredDescription
walletIdstringYesReceiving wallet
customerIdstringYesCustomer to charge
amountstringYesAmount to charge
descriptionstringYesCharge description
recurringobjectNoRecurring schedule

wallgent_void_invoice

Void a finalized invoice that has not been paid. The invoice can no longer be collected.

ParameterTypeRequiredDescription
invoiceIdstringYesInvoice ID

wallgent_refund_invoice

Refund a paid invoice. Returns the funds to the customer and debits your wallet.

ParameterTypeRequiredDescription
invoiceIdstringYesInvoice ID

Compliance (2 tools)

wallgent_compliance_status

Get real-time PCI-DSS compliance status of all security controls.

No parameters required.

wallgent_compliance_evidence

Get summary of recent compliance audit evidence bundles and their pass/fail status.

No parameters required.

Agents (8 tools)

wallgent_create_agent

Create a new AI agent with its own wallet and a wallet-scoped API key. Returns the agent ID, API key secret (shown once), and initial balance.

ParameterTypeRequiredDescription
namestringYesAgent display name
permissionsstring[]NoPermissions for the agent key (defaults to wallets + payments read/write)

wallgent_list_agents

List all agent budgets for the current organization.

No parameters required.

wallgent_get_agent

Get details of a specific agent budget including balance, status, and API key info.

ParameterTypeRequiredDescription
agentIdstringYesThe agent (wallet) ID to retrieve

wallgent_adjust_budget

Adjust an agent budget allocation. Positive amounts increase the budget (fund from org wallet); negative amounts decrease it (return to org wallet).

ParameterTypeRequiredDescription
agentIdstringYesThe agent (wallet) ID to adjust
amountnumberYesAmount to adjust (positive = increase, negative = decrease)

wallgent_pause_agent

Pause an agent budget. Freezes the agent wallet so no outgoing payments can be made.

ParameterTypeRequiredDescription
agentIdstringYesThe agent (wallet) ID to pause

wallgent_resume_agent

Resume a paused agent budget. Unfreezes the agent wallet to allow payments again.

ParameterTypeRequiredDescription
agentIdstringYesThe agent (wallet) ID to resume

wallgent_rotate_agent_key

Rotate an agent's API key. Revokes the current key and issues a new one.

ParameterTypeRequiredDescription
agentIdstringYesThe agent (wallet) ID whose key to rotate

wallgent_delete_agent

Delete an agent, deallocate remaining funds back to the org wallet, and revoke all API keys.

ParameterTypeRequiredDescription
agentIdstringYesThe agent (wallet) ID to delete

Agent Network (2 tools)

wallgent_pay_agent

Pay another agent by their Wallgent address (wg_...). Instant, zero fees. Uses the internal Wallgent payment network instead of external rails.

ParameterTypeRequiredDescription
toAddressstringYesThe recipient Wallgent address (starts with wg_)
amountstringYesThe amount to send (e.g. "50.00")
descriptionstringNoOptional payment description

wallgent_search_directory

Search the Wallgent agent directory to find other agents you can pay. Returns agent names and their Wallgent addresses.

ParameterTypeRequiredDescription
searchstringNoSearch by agent name or address

Webhooks (3 tools)

wallgent_create_webhook

Create a webhook endpoint to receive real-time event notifications.

ParameterTypeRequiredDescription
urlstringYesThe HTTPS URL to receive webhook events
eventsstring[]YesEvent types to subscribe to (e.g. ["payment.posted", "wallet.frozen"])

wallgent_list_webhooks

List all configured webhook endpoints for the organization.

No parameters required.

wallgent_delete_webhook

Delete a webhook endpoint by ID.

ParameterTypeRequiredDescription
webhookIdstringYesThe ID of the webhook to delete

API Keys (3 tools)

wallgent_create_api_key

Create a new API key with specific permissions for programmatic access. The secret is shown only once.

ParameterTypeRequiredDescription
namestringYesA descriptive name for the API key
permissionsstring[]YesPermissions to grant (e.g. ["wallets:read", "payments:write"])
environmentstringNoSANDBOX or PRODUCTION (defaults to SANDBOX)

wallgent_list_api_keys

List all API keys for the organization, including their status, environment, and permissions.

No parameters required.

wallgent_revoke_api_key

Permanently revoke an API key, preventing any further use.

ParameterTypeRequiredDescription
keyIdstringYesThe ID of the API key to revoke

Bank Accounts (2 tools)

wallgent_list_bank_accounts

List linked bank accounts for deposits and withdrawals.

No parameters required.

wallgent_create_bank_account

Link a new bank account for ACH deposits and withdrawals.

ParameterTypeRequiredDescription
accountNumberstringYesThe bank account number
routingNumberstringYesThe 9-digit ABA routing number
accountNamestringYesName on the bank account
accountTypestringYesCHECKING or SAVINGS

Audit Logs (1 tool)

wallgent_query_audit_logs

Query the audit log to see all actions taken on the organization (API calls, config changes, etc.).

ParameterTypeRequiredDescription
actionstringNoFilter by action type (e.g. "wallet.created")
resourcestringNoFilter by resource type (e.g. "wallet", "policy")
fromstringNoStart date (ISO 8601, e.g. "2025-01-01T00:00:00Z")
tostringNoEnd date (ISO 8601)
limitnumberNoNumber of results (max 100)

MCP Integration

Connect AI agents to Wallgent using the Model Context Protocol financial tools server.

SDK Reference

Complete TypeScript SDK reference for server-side integration with Wallgent.

On this page

OverviewWallet Management (9 tools)wallgent_create_walletwallgent_get_walletwallgent_list_walletswallgent_check_balancewallgent_fund_walletwallgent_freeze_walletwallgent_unfreeze_walletwallgent_deposit_walletwallgent_withdraw_walletPayments (3 tools)wallgent_send_paymentwallgent_batch_paymentwallgent_get_transactionsTransfers (2 tools)wallgent_get_transferwallgent_list_transfersPolicies (4 tools)wallgent_get_policieswallgent_create_policywallgent_update_policywallgent_delete_policyApprovals (3 tools)wallgent_list_approvalswallgent_approve_paymentwallgent_reject_paymentDelegations (2 tools)wallgent_list_delegationswallgent_create_delegationCards (4 tools)wallgent_create_cardwallgent_list_cardswallgent_freeze_cardwallgent_unfreeze_cardPayment Links (3 tools)wallgent_create_payment_linkwallgent_list_payment_linkswallgent_cancel_payment_linkCustomers (2 tools)wallgent_create_customerwallgent_list_customersInvoices (6 tools)wallgent_create_invoicewallgent_list_invoiceswallgent_finalize_invoicewallgent_charge_customerwallgent_void_invoicewallgent_refund_invoiceCompliance (2 tools)wallgent_compliance_statuswallgent_compliance_evidenceAgents (8 tools)wallgent_create_agentwallgent_list_agentswallgent_get_agentwallgent_adjust_budgetwallgent_pause_agentwallgent_resume_agentwallgent_rotate_agent_keywallgent_delete_agentAgent Network (2 tools)wallgent_pay_agentwallgent_search_directoryWebhooks (3 tools)wallgent_create_webhookwallgent_list_webhookswallgent_delete_webhookAPI Keys (3 tools)wallgent_create_api_keywallgent_list_api_keyswallgent_revoke_api_keyBank Accounts (2 tools)wallgent_list_bank_accountswallgent_create_bank_accountAudit Logs (1 tool)wallgent_query_audit_logs