# Wallet — Open Finance for AI Agents

> CLI, MCP, and API for AI agents to securely access bank account data via Open Finance (Brazil).

Wallet connects AI agents (Claude, ChatGPT, Codex, Devin, etc.) to the user's bank accounts through Open Finance, the regulated standard by Banco Central do Brasil. The user authenticates once, and the agent gets read-only access to balances, transactions, and spending data.

## Integration Methods

### 1. Claude Desktop / claude.ai (Remote MCP — easiest)

Add as custom integration in Claude settings. URL: https://getwalletai.com/mcp

The server uses OAuth 2.1 — Claude handles auth automatically. The user logs in via Google when prompted.

### 2. Claude Code (CLI + Skill)

```bash
curl -fsSL https://getwalletai.com/install.sh | bash
wallet setup
```

Installs the Wallet CLI and Claude Code skill. Run `wallet setup` to authenticate.

### 3. ChatGPT (Custom GPT Action)

Create a custom GPT, add an Action with the OpenAPI spec URL: https://getwalletai.com/api/agent/openapi.json

Set authentication to API Key (Bearer). Get a token from the Wallet dashboard.

### 4. Any MCP-compatible agent (Codex, Cursor, etc.)

Use the npm package: `npx -y walletai`

Or configure the remote MCP URL: https://getwalletai.com/mcp

### 5. REST API (any agent)

All endpoints require `Authorization: Bearer <token>` header.

- `GET https://getwalletai.com/api/agent/context` — Agent capabilities and connected sources
- `GET https://getwalletai.com/api/agent/balances` — Current balances for all accounts
- `GET https://getwalletai.com/api/agent/accounts` — List connected accounts
- `GET https://getwalletai.com/api/agent/transactions?limit=N` — Recent transactions
- `GET https://getwalletai.com/api/agent/spending-summary` — Current month spending by category
- `POST https://getwalletai.com/api/agent/feedback` — Submit feedback (body: `{ message, category? }`)

## MCP Tools

Tools available via MCP: `wallet_get_balances`, `wallet_get_accounts`, `wallet_get_transactions`, `wallet_get_spending_summary`, `wallet_get_context`, `wallet_submit_feedback`

## CLI Commands

- `wallet setup` — Authenticate and connect bank accounts (opens browser)
- `wallet balances [--json]` — Show all account balances
- `wallet accounts [--json]` — List connected accounts
- `wallet transactions [--limit N] [--json]` — Recent transactions
- `wallet spending [--json]` — Monthly spending by category
- `wallet status [--json]` — Connection and agent status

## Security

- Read-only access — agents cannot move money or modify accounts
- Bearer tokens are SHA-256 hashed before storage
- Per-source grants control which bank connections each agent can access
- Users can revoke agent access anytime from the dashboard

## Links

- [Dashboard](https://getwalletai.com): Manage connections, agents, and permissions
- [Integration Docs](https://getwalletai.com/docs): Full documentation
- [Skill File](https://getwalletai.com/skill.md): Claude Code skill definition
- [Health Check](https://getwalletai.com/health): API status