The MCP door
The MCP door lets your organisation’s own AI agent read the ledger. The agent speaks the Model Context Protocol (MCP), revision 2026-07-28, which most agent tools already speak. It sees the same lists a person with the same permissions sees, and nothing more.
A controller at Woodgrove Bank can ask their agent to reconcile a GL account against the ERP. The agent lists what it may read, reads the journal entries, and cites the ids it read. Every read is kept, and a checker can review it later.
What the door does not do
- No tool changes anything. The door only reads. It cannot post, approve or edit.
- No resource is a record. Records come only through the lists, so the permission check always runs.
- No tool reads another organisation’s data. A door belongs to one organisation, and so does every caller it lets in.
- No row goes to our model vendor. The door uses no model. Your agent chose its own, and the rows go where your organisation sends them.
Who can use the door
Two kinds of caller use the door.
| Caller | How they sign in | What they may read |
|---|---|---|
| A person | Through your organisation’s usual sign-in, in their agent tool | What their own permissions allow |
| An agent | With its own client id and secret, with no person present | What its group’s permissions allow |
An agent is a member of your organisation, in its own group. Give it the group a clerk in the same job would have. An agent can never approve anything, even if its group allows approvals.
Each caller also needs the permission to use the MCP door.
Connect an agent tool as a person
- In your agent tool, add a remote MCP server.
- Enter the door’s address: your platform address, then
/mcp/, then your organisation’s key. For example,https://ledger.woodgrove.example/mcp/woodgrove. - Connect. The tool opens your organisation’s sign-in page.
- Sign in as you usually do.
The agent tool finds the sign-in page by itself. If you are not a member of the organisation in the address, the door refuses you.
If the MCP door is switched off, the door refuses every request. The refusal names MCP Door and says an administrator can switch it on in Settings → Features. If your licence does not include the MCP door, the refusal says so.
Connect an agent that runs on its own
An agent that runs with no person present needs its own credential.
- In your identity provider, register a client for the agent with the client-credentials
grant. Give it access to the audience
ledgertm-mcp. - Note the client id and create a secret. Keep the secret in your own vault.
- Create a user group for the agent in Permissions, and grant it what it may read.
- Ask your platform administrator to register the client id as an agent for your organisation and that group.
- In the agent’s configuration, enter the door’s address, the client id and the secret.
The platform administrator’s registration creates the agent’s member, named by its client id. A client id already used by an institution connection is refused. Register a new one.
Revoking the agent is also a platform administrator’s task. It takes effect within about a minute.
What the agent can see
The agent asks the door for its tools and its resources.
| What | What it is |
|---|---|
| A tool for each list | Every list its permissions allow, such as journal entries or account balances |
| find_tools | Searches those lists by words, such as journal |
| aggregate | Groups a list’s rows by a field and totals them, as the assistant does |
| run_report_sql | Runs one SQL SELECT over your reporting tables. Shown only when your licence includes Reporting tables and the agent holds its permission |
| Guide articles | Every public article in this guide, as text |
| The reporting dictionary | Every reporting table and column, with its description. Shown only when your licence includes Reporting tables |
SQL reads the live book only. There is no “as at” date; for an earlier date, read the day-end tables that carry one. Each statement stops after a time limit and returns a capped number of rows.
Review what an agent read
Every tool call and every resource read is kept. One caller’s calls on one trading date are one conversation.
- Go to the Assistant conversations screen.
- Set Source to MCP door.
- Select a conversation to open it.
You see each call, its parameters, how many rows came back, why it was refused if it was, and the trading date. See The assistant for the columns.
What your organisation configures
- Whether the door is open. It is closed until your organisation switches on Platform › MCP Door in Features. A closed door answers as if it did not exist. It does not need the assistant to be switched on.
- Who may use it. The permission to use the MCP door, granted per group.
- What each agent may read. Its group’s permissions, the same as a person’s.
- Which agent tools connect. Your identity provider registers them, not this platform.
From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.