# Procfy — how to use (mcp.ai)

Gestão financeira no Procfy — transações (receitas/despesas/transferências), contas bancárias, contatos, categorias, centros de custo e usuários, via API REST oficial (api.procfy.io). Pareia com o Banco MCP para conciliar banco × gestão. Autenticação por token de API (Bearer) gerado em Configurações da conta → Tokens de API (admin).

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_procfy?ms=1781045100000`
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. `procfy_create_transaction`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/procfy`
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/procfy/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/procfy/create/transaction` — Cria uma transação na Procfy. `data` é um JSON string com os campos do payload (type, amount, date, bank_account_id, category_id, contact_id, description, ...). Confira o schema em api-docs.procfy.io/
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/procfy/get/bank/account/balance` — Detalha uma conta bancária da Procfy (inclui saldo) por id.
  - body: { bank_account_id: string, account?: string, bank_account_ids?: string[] }
- `POST https://api.mcp.ai/api/procfy/get/transaction` — Detalha uma ou mais transações por id. Passe `transaction_ids` (lista, máx 50) — busca em lote com retry/backoff e erros por-id; ou `transaction_id` único.
  - body: { transaction_id?: string, transaction_ids?: string[], account?: string }
- `POST https://api.mcp.ai/api/procfy/list/accounts` — Lista as conexões (contas) Procfy vinculadas a este install — id, label.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/procfy/list/bank/accounts` — Lista as contas bancárias da Procfy. Paginado.
  - body: { page?: integer, items?: integer, filters?: string, account?: string }
- `POST https://api.mcp.ai/api/procfy/list/categories` — Lista categorias (plano de contas) da Procfy. Paginado.
  - body: { page?: integer, items?: integer, filters?: string, account?: string }
- `POST https://api.mcp.ai/api/procfy/list/contacts` — Lista contatos (clientes/fornecedores) da Procfy. Paginado.
  - body: { page?: integer, items?: integer, filters?: string, account?: string }
- `POST https://api.mcp.ai/api/procfy/list/cost/centers` — Lista centros de custo da Procfy. Paginado.
  - body: { page?: integer, items?: integer, filters?: string, account?: string }
- `POST https://api.mcp.ai/api/procfy/list/transactions` — Lista transações (receita/despesa/transferência/folha/imposto) da Procfy. Paginado (page/items, máx 50/página). Use `filters` (JSON) pra filtrar por data, conta, categoria etc.
  - body: { page?: integer, items?: integer, filters?: string, account?: string }
- `POST https://api.mcp.ai/api/procfy/list/users` — Lista usuários da conta Procfy. Paginado.
  - body: { page?: integer, items?: integer, filters?: string, account?: string }

## Example prompts
- "Liste as transações de despesa deste mês"
- "Qual o saldo das minhas contas bancárias hoje?"
- "Crie uma despesa de R$120 na categoria Software"

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