# Wise — how to use (mcp.ai)

MCP da Wise (https://wise.com), acesso à conta multi-moeda via Personal Token + chave SCA. Lê profiles, balances, transferências, atividades e, crucialmente, extratos completos por moeda incluindo CARD_TRANSACTION (compras com o cartão Wise), que o conector Open Finance brasileiro (Pluggy) não sincroniza. Servidor stateless rodando em Cloudflare Workers; credenciais ficam só na WCA da plataforma.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_wise?ms=1781044200000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `wise_get_balance_statement`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/wise`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/wise/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/wise/get/balance/statement` — Extrato completo de um balance (uma moeda) num período: deposits, withdrawals, conversions, fees, INTEREST e — crucialmente — CARD_TRANSACTION (compras com o cartão de débito Wise). Este é o ÚNICO end
  - body: { profile_id: integer, balance_id: integer, currency: string, interval_start: string, interval_end: string, type?: string, account?: string, profile_ids?: integer[], balance_ids?: integer[] }
- `POST https://api.mcp.ai/api/wise/get/card/transaction` — Detalhe de uma transação de cartão Wise. `token` é o id que apareceu como CARD_PAYMENT em wise_list_activities ou em creditCardMetadata em wise_get_balance_statement.
  - body: { token: string, account?: string }
- `POST https://api.mcp.ai/api/wise/list/activities` — Feed unificado de atividades do profile, mais recente primeiro. Cada item tem type (TRANSFER, CARD_PAYMENT, INTEREST, EXCHANGE, BALANCE_DEPOSIT, …). SCA-protegido.
  - body: { profile_id: integer, size?: integer, next_cursor?: string, since?: string, until?: string, status?: string, monetary_resource_type?: string, account?: string, profile_ids?: integer[] }
- `POST https://api.mcp.ai/api/wise/list/balances` — Lista os saldos multi-moeda de um profile. Cada balance tem um `id` que é usado em wise_get_balance_statement. Default STANDARD; passe 'SAVINGS' pra jars/pots.
  - body: { profile_id: integer, types?: string, account?: string, profile_ids?: integer[] }
- `POST https://api.mcp.ai/api/wise/list/profiles` — Chama a Wise API /v2/profiles e retorna todos os profiles que o Personal Token enxerga (PERSONAL/BUSINESS). Use pra confirmar o profile_id antes de outras tools.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/wise/list/transfers` — Lista transferências (P2P sends + receives) do profile. Filtre por status (CSV de estados como 'incoming_payment_waiting,outgoing_payment_sent'), moeda, datas. SCA-protegido.
  - body: { profile_id: integer, status?: string, source_currency?: string, target_currency?: string, created_date_start?: string, created_date_end?: string, offset?: integer, limit?: integer, account?: string, profile_ids?: integer[] }

## Example prompts
- "Mostre minhas compras de cartão Wise em AED nos últimos 90 dias"
- "Qual o saldo das minhas contas Wise por moeda?"
- "Liste as transferências em EUR feitas pela Wise neste ano"

## More
- Page: https://mcp.ai/wise
- Agent spec (llms.txt): https://mcp.ai/wise/llms.txt
- Postman collection: https://mcp.ai/wise/postman.json