What can you do with the Formance Ledger integration?

LiveContext exposes 41 operations on Formance Ledger, covering metadata, exporter, pipeline and schema.

Formance Ledger integration

Formance Ledger is an open-source, self-hosted programmable financial ledger for modelling money movement. Create and list ledgers with their metadata and storage bucket, post and list double-entry transactions written in Numscript, read one transaction, revert it, and set or delete transaction metadata; list accounts, read one by address and manage its metadata; read aggregated balances, per-account and per-asset volumes with balances, and ledger statistics; group many writes into a single bulk request; list, export and import the ledger's append-only log; manage ledger schemas by version and run stored query templates; and administer buckets and the exporters and pipelines that stream ledger activity to external systems. Only the v2 API is exposed; the deprecated unversioned routes of the same document are not. The host is part of the credential because every install is its own deployment. Authentication is a bearer access token, issued by Formance's authentication service through the client-credentials grant or by whatever gateway fronts a self-hosted deployment.

41 toolsTokenAPI docs

Connect Formance Ledger How integrations work

What you can do with Formance Ledger

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Metadata, 6 operations

POSTadd_metadata_to_account
Add metadata to an account.
POSTadd_metadata_to_transaction
Set the metadata of a transaction by its ID.
DELETEdelete_account_metadata
Delete metadata by key.
DELETEdelete_ledger_metadata
Delete ledger metadata by key.
DELETEdelete_transaction_metadata
Delete metadata by key.
PUTupdate_ledger_metadata
Update ledger metadata.

Exporter, 5 operations

POSTcreate_exporter
Create exporter.
DELETEdelete_exporter
Delete exporter.
GETget_exporter_state
Get exporter state.
GETlist_exporters
List exporters.
PUTupdate_exporter
Update exporter.

Pipeline, 4 operations

POSTcreate_pipeline
Create pipeline.
DELETEdelete_pipeline
Delete pipeline.
GETget_pipeline_state
Get pipeline state.
GETlist_pipelines
List pipelines.

Schema, 3 operations

POSTcreate_schema
Insert a schema for a ledger.
GETget_schema
Get a schema for a ledger by version.
GETlist_schemas
List all schemas for a ledger.

Transaction, 3 operations

POSTcreate_transaction
Create a new transaction to a ledger.
GETget_transaction
Get transaction from a ledger by its ID.
GETlist_transactions
List transactions from a ledger.

V2, 3 operations

POSTcreate_ledger
Create a ledger.
GETget_ledger
Get a ledger.
GETlist_ledgers
List ledgers.

Account, 2 operations

GETget_account
Get account by its address.
GETlist_accounts
List accounts from a ledger.

Balance, 1 operation

GETget_aggregated_balances
Get the aggregated balances from selected accounts.

Bucket, 1 operation

DELETEdelete_bucket
Delete bucket.

Bulk, 1 operation

POSTrun_bulk_request
Bulk request.

Export, 1 operation

POSTexport_logs
Export logs.

Import, 1 operation

POSTimport_logs
create import.

Info, 1 operation

GETget_ledger_info
Get information about a ledger.

Log, 1 operation

GETlist_logs
List the logs from a ledger.

Reset, 1 operation

POSTreset_pipeline
Reset pipeline.

Restore, 1 operation

POSTrestore_bucket
Restore bucket.

Revert, 1 operation

POSTrevert_transaction
Revert a ledger transaction by its ID.

Run, 1 operation

POSTrun_query_template
Run a query template.

Start, 1 operation

POSTstart_pipeline
Start pipeline.

Stat, 1 operation

GETget_ledger_stats
Get statistics from a ledger.

Stop, 1 operation

POSTstop_pipeline
Stop pipeline.

Volume, 1 operation

GETlist_volumes_with_balances
Get list of volumes with balances for (account/asset).

Use Formance Ledger from Claude Code, Cursor or Codex

Connect Formance Ledger in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Formance Ledger operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Formance Ledger

Create your workspace
Sign up free. Nothing to install.
Connect Formance Ledger once
Add your Formance Ledger connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Formance Ledger integration FAQ

What can you do with the Formance Ledger integration?: LiveContext exposes 41 operations on Formance Ledger, covering metadata, exporter, pipeline and schema.