Finance Studio — Multica

Loading source-backed insight…

Current insight

—

Workspace context pending

Evidence canvas

Coverage across the selected source

Insight version — Source version —

—

Inspect source-backed values

Measure	Value	Source	Location	Captured hash	Insight version	Source version	Derivation

Evidence is ready for a human choice

No payment, ledger post, or Files write is performed here.

Human record boundary

Decide from the cited insight

Review the evidence, choose one option, and append a decision record. This action never moves money or updates an external finance system.

Open Home and load a valid insight before recording a decision.

Selected insight

—

Narrative summary

—

Observed: —
Source hash: —
Insight version: —
Source version: —
Derived: —

Option comparison

Choose one path

One choice only

Decision option

Decision note (optional)

Confirmation requires the current insight version and sends If-Match plus Idempotency-Key.

Decision history

Recorded	Choice	Insight version	Actor

Read + proposal surface

Agent API

Workspace-scoped REST and MCP documentation for reading source-backed insights and proposing a decision. Agents cannot apply decisions or write to Files.

Base URL

https://ss-finance.ocuss.app

Authentication

multica_auth + membership for the UI; workspace access token for agents. Workspace identity is resolved server-side.

GET/api/agent/finance/sources

List authorized source snapshots and immutable Files metadata for the resolved workspace.

Querylimit, cursor, optional source/status filters. No body workspace authority.

GET/api/agent/finance/insights

Read persisted deterministic insights, claims, versions, and citation metadata without UI scraping.

Claim tuple{file_id, content_sha256, location_span} is required for every factual value.

POST/api/agent/finance/proposals

Preview a claim explanation, option comparison, or decision draft using existing insight and claim IDs.

BoundaryProposal-only. The response never appends a decision and cannot supply a new numeric fact.

GET/api/agent/finance/decisions

Read append-only decision records and their cited insight/source versions.

Read onlyAgents may inspect records but cannot call the human apply boundary.

POST/api/decisions/applyhuman only

Append one decision after the human reviews the cited insight and selects one option.

HeadersIf-Match: <insight-version> + non-empty Idempotency-Key. Stale or conflicting requests do not append.

MCP tools

The released Finance tool surface is read/proposal-only and resolves workspace authority from the agent grant.

select_claimproposal

explain_claimproposal

compare_claimsproposal

draft_decisionproposal

Response contract

{
  "insight_id": "…",
  "version": "…",
  "claims": [{
    "claim_id": "…",
    "value": 0,
    "provenance": {
      "file_id": "…",
      "content_sha256": "…",
      "location_span": {"row": 0, "column": "…"}
    }
  }]
}

Quick Reference

# List persisted insights

curl -sS "https://ss-finance.ocuss.app/api/agent/finance/insights?workspace=$MULTICA_WORKSPACE_ID" \
  -H "Authorization: Bearer $WORKSPACE_ACCESS_TOKEN"

# Preview a proposal from cited claims

curl -sS -X POST "https://ss-finance.ocuss.app/api/agent/finance/proposals?workspace=$MULTICA_WORKSPACE_ID" \
  -H "Authorization: Bearer $WORKSPACE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"insight_id":"<insight-id>","claim_ids":["<claim-id>"],"operation":"compare"}'

# Human-only append boundary

curl -sS -X POST "https://ss-finance.ocuss.app/api/decisions/apply?workspace=$MULTICA_WORKSPACE_ID" \
  -H "If-Match: <insight-version>" -H "Idempotency-Key: <new-key>" \
  -H "Content-Type: application/json" -d '{"insight_id":"<insight-id>","option_id":"<option-id>"}'

Unavailable by design

No general-ledger post, payment, money movement, external finance write, Files write, authority grant, or agent decision apply exists in Finance V1.

Select a source to begin

—

Coverage across the selected source