{
  "info": {
    "name": "Poupa AI — mcp.ai",
    "description": "REST API for the Poupa AI MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/poupa",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "poupa_add_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "transaction"
          ]
        },
        "description": "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).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"value\": 0,\n  \"date\": \"\",\n  \"description\": \"\",\n  \"category\": \"\",\n  \"payment_bank\": \"\",\n  \"card_name\": \"\",\n  \"installments\": 0,\n  \"expense_recurrency\": 0,\n  \"recurrency_array_dates\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_add_transactions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/transactions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "transactions"
          ]
        },
        "description": "Cria várias transações de uma vez (bulk). transactions[] é obrigatório; cada item segue o mesmo shape de poupa_add_transaction.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"transactions\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_banks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/banks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "banks"
          ]
        },
        "description": "Lista os bancos/contas do usuário.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_cards",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/cards",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "cards"
          ]
        },
        "description": "Lista os cartões de crédito do usuário.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_category",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/category",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "category"
          ]
        },
        "description": "Lista as categorias do usuário.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_defaults",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/defaults",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "defaults"
          ]
        },
        "description": "Categorias e métodos de pagamento padrão do usuário.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_delete_transactions_by_filter",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/transactions/by/filter",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "transactions",
            "by",
            "filter"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\",\n  \"start_date\": \"\",\n  \"end_date\": \"\",\n  \"description\": \"\",\n  \"category\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_get_balance",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/balance",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "balance"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"start_date\": \"\",\n  \"end_date\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_memories",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/memories",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "memories"
          ]
        },
        "description": "Memórias/notas do usuário gravadas no Poupa AI.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_preferences",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/preferences",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "preferences"
          ]
        },
        "description": "Preferências do usuário (idioma, moeda, etc.).",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_retrieve_transactions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/transactions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "transactions"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"start_date\": \"\",\n  \"end_date\": \"\",\n  \"keywords\": \"\",\n  \"card_name\": \"\",\n  \"payment_bank\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_transfer_between_banks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/transfer/between/banks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "transfer",
            "between",
            "banks"
          ]
        },
        "description": "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).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"from_bank\": \"\",\n  \"to_bank\": \"\",\n  \"value\": 0,\n  \"date\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "poupa_update_transactions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/transactions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "transactions"
          ]
        },
        "description": "Atualiza uma ou mais transações existentes. Informe os ids alvo no filtro e os campos a alterar (passthrough).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\",\n  \"filter\": {},\n  \"changes\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}