agentis-pay

Install

Build and install the CLI locally with:

./scripts/install-agentis-pay.sh

Options:

• --bin-dir to change the binary destination (default: ~/.local/bin).
• Shell completion installation is currently not bundled in this CLI package.

Usage

Discover available commands with:

agentis-pay --help
agentis-pay pay --help

Example commands:

agentis-pay signup --email user@example.com --cpf 123.456.78901 --phone "+55 (11) 99999 0000"
agentis-pay pay --key 12345678901 --amount 12,34 --note "coffee"
agentis-pay pay --key 12345678901 --amount-cents 1234 --note "coffee"
agentis-pay keys
agentis-pay history --limit 10

MCP

Install and run the MCP server in read-only mode (default):

agentis-pay login
agentis-pay mcp install --client claude --mode readonly

The generated JSON can be pasted directly into Claude Desktop config. For local MCP clients, agentis-pay mcp serve automatically reuses the session already saved by the CLI in ~/.agentis-pay/credentials.json, including refreshable auth state and the persisted installation/device identity. The MCP command surface intentionally exposes only:

• agentispay_signup
• agentispay_login
• agentispay_whoami
• agentispay_status
• agentispay_account
• agentispay_balance
• agentispay_history
• agentispay_deposit
• agentispay_limits
• agentispay_pix_lookup
• agentispay_pay (and optional alias agentispay_pix_send)

Trust-related tools are intentionally omitted from MCP for now.

Most local agents should use the saved-login flow above and avoid embedding JWTs in config files. For advanced cases, MCP still supports explicit env overrides:

AGENTIS_PAY_OUTPUT=json \
AGENTIS_PAY_JWT=<token> \
AGENTIS_PAY_AGENT_NAME=<name> \
AGENTIS_PAY_DEVICE_ID=<device-id> \
agentis-pay mcp serve --stdio --mode readonly

To allow payment execution, run MCP in write mode:

agentis-pay mcp serve --stdio --mode write

Include a request_id and optional idempotency_key for production-safe retries:

{
  "name": "agentispay_pay",
  "arguments": {
    "key": "alice@pix",
    "amount_cents": 1250,
    "request_id": "request-123e4567",
    "idempotency_key": "idem-123e4567"
  }
}

agentispay_pay returns the transfer result:

{
  "request_id": "request-123e4567",
  "status": "paid",
  "key": "alice@pix",
  "owner_name": "Alice Cooper",
  "key_type": "pix",
  "amount_cents": 1250,
  "amount_brl": "R$ 12.50",
  "note": ""
}