CLI & MCP

One interface for
humans and agents.

Every CLI command is also an MCP tool and a REST API endpoint. The CLI is your interface. The MCP server is the agent's interface. Same backend.


Get started

Up and running
in three commands

Install the CLI, authenticate, connect to your AI agent. Everything after that is handled by your agent.

terminal
$ npm install -g aipaysh
$ aipay auth
  Enter your email click the magic link authenticated
$ aipay setup-mcp
  ✓ MCP config written
  ✓ 25 tools registered
  ✓ Ready to connect to Claude

CLI Commands

Eight resource groups.
One unified interface.

Manage agents, cards, IBANs, credit, crypto, policies, invoices, and audit logs from a single CLI.

aipay agents register
Register an AI agent with KYA identity. Returns scoped credentials. Required before any financial activity.
--name--framework--purpose
aipay cards create
Issue a virtual Mastercard. Single-use or persistent. Multi-currency. Funded from balance, credit, or stablecoins.
--amount--currency--agent--single-use
aipay ibans create
Provision a virtual IBAN for an agent. Receive SEPA, Faster Payments, or wire transfers directly.
--currency--agent--label
aipay credit allocate
Distribute your business credit line to an agent. The agent creates credit-backed cards up to the allocated amount.
--agent--amount--currency
aipay crypto fund
Convert USDC or USDT to fiat and deposit into a card or IBAN. Real-time exchange rate shown before confirmation.
--to--amount--token
aipay policies create
Define a programmable spending policy: per-txn limits, daily caps, merchant restrictions, approval thresholds.
--max-txn--daily-limit--allowed-mcc
aipay invoices pay
Trigger payment for a verified invoice. Supports multi-currency and extended 90-day interest-free terms.
--source--agent
aipay audit log --follow
Stream the live audit log. Every transaction, card creation, policy change, and anomaly alert in real time.
--agent--since--type

MCP Integration

25 tools for Claude.
Zero configuration.

Run aipay setup-mcp and Claude gets direct access to every capability. Destructive actions require your approval. Read-only actions execute instantly.

registered MCP tools
  create_cardIssue a virtual card for an agent
  create_ibanProvision a virtual IBAN
  get_card_detailsRetrieve PAN, CVV, expiry on demand
  check_balanceQuery card or IBAN balance
  freeze_cardInstant freeze / unfreeze a card
  transfer_fundsMove funds between IBANs
  credit_statusView credit line details
  allocate_creditAssign credit to an agent
  fund_from_cryptoConvert stablecoin to fiat
  pay_invoiceTrigger supplier payment
  list_transactionsView transaction history
  register_agentRegister a new AI agent (KYA)
  list_agentsList all registered agents
  get_agentGet details of a specific agent
  create_policyCreate a spending policy
  list_policiesList all active policies
  delete_policyRemove a spending policy
  list_cardsList all active cards
  cancel_cardCancel a virtual card
  list_ibansList all virtual IBANs
  get_ibanGet IBAN details and balance
  list_invoicesList pending invoices
  get_audit_logRetrieve audit log entries
  crypto_ratesGet real-time exchange rates
  crypto_deposit_addressGet deposit address for funding

Install the CLI. Connect your agent.

Three commands. No credit card required.