# fin_deletar_bill

Hard-delete de uma bill recorrente. Só funciona se NENHUMA ocorrência foi paga. QUANDO USAR: remover bill criada por engano (nome/categoria errada) antes de qualquer pagamento. NÃO USAR QUANDO: a bill já tem ocorrências pagas — use fin_editar_bill com is_active: false (soft-delete, preserva histórico). CAMPOS: - bill_id: string UUID (obrigatório). REGRAS DE NEGÓCIO: - Se a bill tem ≥1 ocorrência com transaction_id != null, retorna 409 com soft_delete_hint. - Ocorrências NÃO pagas são deletadas em cascata (FK ON DELETE CASCADE).

Agent View of the PolicyLayer registry record for `fin_deletar_bill`. HTML page: https://policylayer.com/tools/genius-fin-mcp/fin-deletar-bill

## Facts

- Tool: `fin_deletar_bill`
- Server: Genius Fin (`genius-fin-mcp`) — https://policylayer.com/tools/genius-fin-mcp.md
- Install: `npx -y genius-fin-mcp`
- Homepage: https://www.npmjs.com/package/genius-fin-mcp
- Risk category: Destructive (Critical risk)
- Registry record: grade F, identity unverified
- Server rate-limited: no
- Parameters: 0
- Recommended policy verdict: Hidden

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "fin_deletar_bill",
    "arguments": {}
  }
}
```

## Why fin_deletar_bill is rated Critical

An AI agent that decides to call fin_deletar_bill doesn't hesitate, doesn't double-check, and doesn't stop at one. Whatever it removes from Genius Fin is gone. There is no undo for destructive operations.

## Use case

AI agents call fin_deletar_bill to permanently remove resources in Genius Fin, typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.

## Recommended policy (PolicyLayer)

Verdict: **Hidden**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Genius Fin:

```json
{
  "version": "1",
  "default": "deny",
  "hide": [
    "fin_deletar_bill"
  ]
}
```

## Other tools on Genius Fin (21)

- `fin_deletar_transacao` — Destructive — https://policylayer.com/tools/genius-fin-mcp/fin-deletar-transacao.md
- `fin_editar_bill` — Destructive — https://policylayer.com/tools/genius-fin-mcp/fin-editar-bill.md
- `fin_buscar_transacoes` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-buscar-transacoes.md
- `fin_contexto` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-contexto.md
- `fin_criar_categoria` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-criar-categoria.md
- `fin_criar_subcategoria` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-criar-subcategoria.md
- `fin_criar_transferencia` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-criar-transferencia.md
- `fin_editar_categoria` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-editar-categoria.md
- `fin_editar_occurrence` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-editar-occurrence.md
- `fin_editar_subcategoria` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-editar-subcategoria.md
- `fin_editar_transacao` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-editar-transacao.md
- `fin_fatura_transacoes` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-fatura-transacoes.md
- `fin_listar_bills` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-listar-bills.md
- `fin_listar_categorias` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-listar-categorias.md
- `fin_listar_contas` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-listar-contas.md
- `fin_listar_regras` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-listar-regras.md
- `fin_pagar_fatura` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-pagar-fatura.md
- `fin_receitas` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-receitas.md
- `fin_relatorio` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-relatorio.md
- `fin_saldos` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-saldos.md
- `fin_todas_transacoes` — Other — https://policylayer.com/tools/genius-fin-mcp/fin-todas-transacoes.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=genius-fin-mcp · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/genius-fin-mcp