Integration

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.

Connect Formance Ledger How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Formance Ledger.Built from the 41 Formance Ledger tools below, on the connection you add once.

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

add_metadata_to_accountAdd metadata to accountPOSTAdd metadata to an account.
add_metadata_to_transactionAdd metadata to transactionPOSTSet the metadata of a transaction by its ID.
delete_account_metadataDelete account metadataDELETEDelete metadata by key.
delete_ledger_metadataDelete ledger metadataDELETEDelete ledger metadata by key.
delete_transaction_metadataDelete transaction metadataDELETEDelete metadata by key.
update_ledger_metadataUpdate ledger metadataPUTUpdate ledger metadata.

Exporter, 5 operations

create_exporterCreate exporterPOSTCreate exporter.
delete_exporterDelete exporterDELETEDelete exporter.
get_exporter_stateGet exporter stateGETGet exporter state.
list_exportersList exportersGETList exporters.
update_exporterUpdate exporterPUTUpdate exporter.

Pipeline, 4 operations

create_pipelineCreate pipelinePOSTCreate pipeline.
delete_pipelineDelete pipelineDELETEDelete pipeline.
get_pipeline_stateGet pipeline stateGETGet pipeline state.
list_pipelinesList pipelinesGETList pipelines.

Schema, 3 operations

create_schemaCreate schemaPOSTInsert a schema for a ledger.
get_schemaGet schemaGETGet a schema for a ledger by version.
list_schemasList schemasGETList all schemas for a ledger.

Transaction, 3 operations

create_transactionCreate transactionPOSTCreate a new transaction to a ledger.
get_transactionGet transactionGETGet transaction from a ledger by its ID.
list_transactionsList transactionsGETList transactions from a ledger.

V2, 3 operations

create_ledgerCreate ledgerPOSTCreate a ledger.
get_ledgerGet ledgerGETGet a ledger.
list_ledgersList ledgersGETList ledgers.

Account, 2 operations

get_accountGet accountGETGet account by its address.
list_accountsList accountsGETList accounts from a ledger.

Balance, 1 operation

get_aggregated_balancesGet aggregated balancesGETGet the aggregated balances from selected accounts.

Bucket, 1 operation

delete_bucketDelete bucketDELETEDelete bucket.

Bulk, 1 operation

run_bulk_requestRun bulk requestPOSTBulk request.

Export, 1 operation

export_logsExport logsPOSTExport logs.

Import, 1 operation

import_logsImport logsPOSTcreate import.

Info, 1 operation

get_ledger_infoGet ledger infoGETGet information about a ledger.

Log, 1 operation

list_logsList logsGETList the logs from a ledger.

Reset, 1 operation

reset_pipelineReset pipelinePOSTReset pipeline.

Restore, 1 operation

restore_bucketRestore bucketPOSTRestore bucket.

Revert, 1 operation

revert_transactionRevert transactionPOSTRevert a ledger transaction by its ID.

Run, 1 operation

run_query_templateRun query templatePOSTRun a query template.

Start, 1 operation

start_pipelineStart pipelinePOSTStart pipeline.

Stat, 1 operation

get_ledger_statsGet ledger statsGETGet statistics from a ledger.

Stop, 1 operation

stop_pipelineStop pipelinePOSTStop pipeline.

Volume, 1 operation

list_volumes_with_balancesList volumes with balancesGETGet 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.