# F360 Finanças — how to use (mcp.ai)

Financial and accounting reconciliation on F360 Finanças (management for retail chains and franchises), card reconciliation, accounting/managerial reports, transfers between accounts, charts of accounts, customers/suppliers and invoices, via the official Public API. Read-only. Pairs with the Banco MCP to reconcile bank statements with card reconciliation. Auth via the API key generated in the F360 account under Webservices.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/f360/baixar/relatorio` — Baixa o resultado de um relatório já gerado (Download?id=). Use o `id` devolvido por uma das tools f360_relatorio_*.
  - body: { id: string, account?: string, ids?: string[] }
- `POST https://api.mcp.ai/api/f360/list/accounts` — Lista as contas/empresas F360 conectadas a este install — id, label.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/f360/listar/classificacao/produtos` — Lista as classificações de produtos (ListarClassificacaoProdutos).
  - body: { account?: string }
- `POST https://api.mcp.ai/api/f360/listar/notas` — Lista notas fiscais (ListarNotas). Paginado por `pagina`. Filtros: `registro` (ex.: NFSe), `inicio`/`fim` (ISO AAAA-MM-DD), `tipo` (ex.: Criação), `empresas` (CNPJs separados por vírgula), `cliente_fo
  - body: { pagina?: integer, registro?: string, inicio?: string, fim?: string, tipo?: string, empresas?: string, cliente_fornecedores?: string, account?: string }
- `POST https://api.mcp.ai/api/f360/listar/pessoas` — Lista pessoas (clientes/fornecedores) (ListarPessoas). Paginado por `pagina`. `definicao` filtra o tipo ("ambos", "clientes", "fornecedores").
  - body: { pagina?: integer, definicao?: string, account?: string }
- `POST https://api.mcp.ai/api/f360/listar/planos/contas` — Lista os planos de contas (ListarPlanosContas).
  - body: { account?: string }
- `POST https://api.mcp.ai/api/f360/obter/danfe` — Obtém o DANFE de uma nota por id (ObterDanfe).
  - body: { id: string, account?: string, ids?: string[] }
- `POST https://api.mcp.ai/api/f360/obter/pessoa` — Detalha uma pessoa por id (ObterPessoa).
  - body: { id: string, account?: string, ids?: string[] }
- `POST https://api.mcp.ai/api/f360/obter/plano/contas` — Detalha um plano de contas por id (ObterPlanoDeContas).
  - body: { id: string, account?: string, ids?: string[] }
- `POST https://api.mcp.ai/api/f360/obter/xml` — Obtém o XML de uma nota por id (ObterXML).
  - body: { id: string, account?: string, ids?: string[] }
- `POST https://api.mcp.ai/api/f360/relatorio/conciliacao/cartoes` — Gera o relatório de CONCILIAÇÃO DE CARTÕES (GerarRelatorioDeConciliacaoDeCartoes) por período. É a base da conciliação (pareia com o Banco MCP). Pode devolver um id, baixe com f360_baixar_relatorio.
  - body: { data_inicio: string, data_fim: string, tipo_conciliacao?: string, cnpj_empresas?: string[], account?: string }
- `POST https://api.mcp.ai/api/f360/relatorio/contabil` — Gera o relatório contábil/gerencial (GerarRelatorio). Período por `data_inicio`/`data_fim` (ISO AAAA-MM-DD). Pode devolver um id de relatório, baixe com f360_baixar_relatorio.
  - body: { data_inicio: string, data_fim: string, modelo_contabil?: string, modelo_relatorio?: string, contas?: string, cnpj_empresas?: string[], account?: string }
- `POST https://api.mcp.ai/api/f360/relatorio/transferencias` — Gera o relatório de transferências entre contas (GerarRelatorioTransferenciasEntreContas) por período. Pode devolver um id, baixe com f360_baixar_relatorio.
  - body: { data_inicio: string, data_fim: string, cnpj_empresas?: string[], account?: string }

## Example prompts
- "Generate last week's card reconciliation"
- "List the invoices issued in May"
- "Show this month's managerial report"

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