# Poupa AI — MCP server on mcp.ai
> Finanças pessoais do Poupa AI. Leia saldo agrupado por banco/categoria/cartão/mês, transações por intervalo e palavra-chave, lista de bancos, cartões e categorias; registre, atualize ou apague transações (uma a uma ou em lote) e movimente entre suas contas. Autentique com a sua API key do Poupa AI.

By: mcp.ai · official
Page: https://mcp.ai/poupa

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_poupa?ms=1781858280000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/poupa/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/poupa/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/poupa/skill.md
Postman collection (v2.1): https://mcp.ai/poupa/postman.json

## Tools
- poupa_add_transaction(value: number, date: string, description?: string, category?: string, payment_bank?: string, card_name?: string, installments?: number, expense_recurrency?: number, recurrency_array_dates?: string[]) — Cria uma transação. value e date são obrigatórios; demais campos opcionais. Para parcelar, use installments; para recorrer, use expense_recurrency (dias) OU recurrency_array_dates (lista de datas).
- poupa_add_transactions(transactions: object[]) — Cria várias transações de uma vez (bulk). transactions[] é obrigatório; cada item segue o mesmo shape de poupa_add_transaction.
- poupa_banks() — Lista os bancos/contas do usuário.
- poupa_cards() — Lista os cartões de crédito do usuário.
- poupa_category() — Lista as categorias do usuário.
- poupa_defaults() — Categorias e métodos de pagamento padrão do usuário.
- poupa_delete_transactions_by_filter(ids?: string[], start_date?: string, end_date?: string, description?: string, category?: string) — Deleta transações por filtro. O filtro precisa ser não vazio (a tool se recusa a deletar tudo). Aceita ids, intervalo de datas, descrição, categoria, etc.
- poupa_get_balance(start_date?: string, end_date?: string) — Saldo do usuário, agrupado por banco, categoria, método de pagamento, cartão, tipo (entrada/saída) e mês. start_date/end_date (YYYY-MM-DD) limitam a janela; sem datas, traz tudo.
- poupa_memories() — Memórias/notas do usuário gravadas no Poupa AI.
- poupa_preferences() — Preferências do usuário (idioma, moeda, etc.).
- poupa_retrieve_transactions(start_date?: string, end_date?: string, keywords?: string[], card_name?: string, payment_bank?: string) — Lista transações no intervalo (YYYY-MM-DD), opcionalmente filtradas por palavras-chave (match parcial case-insensitive na descrição), cartão e/ou banco/pagador.
- poupa_transfer_between_banks(from_bank: string, to_bank: string, value: number, date?: string) — Registra uma transferência entre dois bancos/contas do PRÓPRIO usuário (movimento contábil — não executa transferência bancária real). value é o valor; date opcional (default = hoje).
- poupa_update_transactions(ids?: string[], filter?: object, changes?: object) — Atualiza uma ou mais transações existentes. Informe os ids alvo no filtro e os campos a alterar (passthrough).

## Example prompts
- "Qual o saldo deste mês por categoria?"
- "Lista todas as transações com a palavra Uber nos últimos 30 dias"
- "Registra uma despesa de R$150 hoje no cartão Nubank em alimentação"

## Links
Docs: https://mcp.ai/docs/mcps/poupa
Website: https://mcp.ai/mcps/poupa