Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Claude Code plugin

The repository is also a Claude Code plugin marketplace. Its freeagent plugin adds the server’s MCP connection and the 14 prompts as slash commands.

Install

In Claude Code:

/plugin marketplace add Trozz/mcp-freeagent
/plugin install freeagent@mcp-freeagent

The plugin connects to http://localhost:7771/freeagent, the address of a server run locally as in Getting started. To use another server, set FREEAGENT_MCP_URL in the environment Claude Code starts in:

export FREEAGENT_MCP_URL=https://freeagent-mcp.example.com/freeagent

Then run /mcp, choose freeagent and authenticate: your browser shows the server’s consent page, then FreeAgent’s login.

Commands

Each prompt is a command named after it, with - for _:

CommandPrompt
/freeagent:business-snapshot [focus]business_snapshot
/freeagent:monthly-bookkeeping [month]monthly_bookkeeping
/freeagent:explain-transactions [bank_account] [period]explain_transactions
/freeagent:approve-guesses [bank_account]approve_guesses
/freeagent:chase-overdue [tone] [customer]chase_overdue
/freeagent:create-invoice <request>create_invoice
/freeagent:invoice-unbilled-time [client]invoice_unbilled_time
/freeagent:log-time <work>log_time
/freeagent:record-expense [details]record_expense
/freeagent:vat-check [period]vat_check
/freeagent:tax-deadlines [months]tax_deadlines
/freeagent:month-end-close [month]month_end_close
/freeagent:director-loan-review [as_at]director_loan_review
/freeagent:cashflow-review [months]cashflow_review

Type the arguments in plain words after the command, for example /freeagent:explain-transactions September 2026 or /freeagent:log-time 3h on the Acme website yesterday. The command reads each argument from what you typed and asks for a required one that is missing. Commands behave as the prompts do: nothing changes in FreeAgent until you agree.

The commands use the plugin’s own freeagent server, whose tools Claude Code shows with a prefix such as mcp__freeagent__.

What is in it

PathContents
.claude-plugin/marketplace.jsonThe marketplace, listing the freeagent plugin from ./plugin
plugin/.claude-plugin/plugin.jsonThe plugin’s name, description and version
plugin/.mcp.jsonThe MCP server: HTTP at ${FREEAGENT_MCP_URL:-http://localhost:7771/freeagent}
plugin/commands/*.mdOne command per prompt

The command files are generated from the prompts in crates/mcp-freeagent-books/src/prompts.rs, so the commands and the server’s prompts say the same thing. After changing a prompt, regenerate them:

UPDATE_PLUGIN=1 cargo test -p mcp-freeagent-books plugin

A test fails if the files and the prompts drift apart.