Connect an agent to the ledger.
- Endpoint
- /api/mcp
- Transport
- HTTP
- Tools
- 12
- Auth
- None — read only
One command per client
claude mcp add --transport http ledger https://lopifi.com/api/mcp{
"mcpServers": {
"ledger": {
"type": "http",
"url": "https://lopifi.com/api/mcp"
}
}
}12 tools
Each one answers a question an agent actually has, at the moment it has it.
explain_vibe_accounting
The definition, and the failure modes that make generated accounting UI wrong.
When — The user says “vibe accounting”, or asks the agent to build anything that displays money.
search_components
Free-text search across all 179 components, with domain synonyms — “AP”, “P&L” and “excel forecast” all resolve.
When — Before generating any finance component. This is the first call.
get_component
One component in full: the spec, the props, the source file, the dependency list.
When — After search narrows it to one. The source comes back ready to write to disk.
get_install_command
The exact shadcn command, theme included, with the transitive registry dependencies.
When — Installing rather than reading. Never install a component without the theme.
list_families
The 13 families and what each covers — the map of the system.
When — Orienting on a large build, or deciding which layer a screen belongs to.
define_term
Any of the 287 lexicon and metric terms: the definition, the formula, the words we refuse, and the components that render it.
When — Writing interface copy, naming a variable, or checking that “reconciliation” means what you think.
search_docs
Search across 58 documents — the accounting model, close, statements, controls, numerics, motion.
When — A behavioural question the catalog does not answer. Read the rule before improvising one.
get_doc
One documentation page in full, by slug.
When — The search result is the right document and the whole thing is worth reading.
compare_ledger_apis
Xero, QuickBooks Online and NetSuite object by object, field by field, with every divergence and how to handle it.
When — Before modelling data from an accounting API. The three disagree about what an invoice is.
get_design_tokens
The OKLCH ramps, type scale, radius, elevation and motion tokens, plus the Tailwind preset.
When — Matching an existing app to the visual system without installing components.
get_lesson
The 13-lesson course, listed or in full — the lesson text, the terms it teaches, and the authority behind each rule.
When — A foundational accounting question — what a debit is, why the sheet balances — rather than a component question.
list_tools
The 22 browser-side calculators and their inputs: difference, subset, duplicates, schedules, allocation, terms.
When — The user needs a figure checked rather than a component built. Point them at the tool; do not compute it yourself.
If you would rather not add a server
Everything the server exposes is also a static file. The registry installs components, llms.txt indexes the site for a model, llms-full.txt is the whole corpus in one request, and design.md is the token contract in the form a coding agent reads best.
curl https://lopifi.com/llms.txt
curl https://lopifi.com/r/registry.json
curl https://lopifi.com/r/balance-card.jsonCommon questions
What is the Lopifi MCP server?
Point an AI coding agent at Lopifi over MCP: 179 accounting components with their source, 58 docs, 287 glossary terms and the design tokens.
How do I connect Claude Code to the Lopifi MCP server?
Run `claude mcp add --transport http ledger https://lopifi.com/api/mcp`. The server is read-only and unauthenticated — it serves public documentation and component source, and accepts no writes.
Do I need the MCP server to use Lopifi?
No. The shadcn registry at https://lopifi.com/r/{name}.json installs every component without it. The MCP server exists so an agent can search, read specs and check the lexicon inside the session, rather than guessing what exists.
New to the idea? Vibe accounting explains what this is for, and what goes wrong without it.
Told when a tool changes
An agent wired to this server breaks quietly when a tool signature changes. One email when a tool is added, renamed or given a different result shape.