Connectors · Accounting & finance
FreeAgent MCP server for AI agents.
actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to FreeAgent and the rest of your systems. It gives your agent 203 FreeAgent actions (93 reads, 83 writes and 27 that wait for a confirmation) and holds the FreeAgent credential itself, so the agent never does. It paces FreeAgent's limits and records every call. Connecting FreeAgent needs your own FreeAgent OAuth app and one admin sign-in.
100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.
claude mcp add --transport http actionlake https://connect.actionlake.com/mcpdo { action: "freeagent.invoices.list", intent: "check which FreeAgent account is connected"}# List all invoices · read · 1 upstream call- 203actionsin one signed file
- 93readlook, never change
- 83writecreate and update
- 27wait for a yesdestructive, confirmed first
Set up
Connect FreeAgent in three steps.
- 01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp - 02
Connect FreeAgent.
OAuth 2.0, authorization code. You register your own OAuth app with FreeAgent, an admin signs in once, and you paste the app's client id and secret and the tokens from that sign-in; actionlake renews the access token from then on. actionlake stores what you paste write-only, sealed under your tenant's key.
Before the first sign-in, FreeAgent needs an OAuth app of your own, registered in its developer portal. actionlake has no FreeAgent app to lend you.
access_tokenAccess token from one sign-in with your own OAuth apprefresh_tokenRefresh token from the same sign-in; the access token is renewed from itclient_idFreeAgent OAuth identifierclient_secretFreeAgent OAuth secret for the same app
account { op: "connections.requirements", service: "freeagent" } # free: exactly what to paste, and what is found for you - 03
Make the first call. Check before a write.
Ask in plain words; Claude picks the action. Before anything changes,
checkvalidates the call and prices it, for free.do { action: "freeagent.invoices.list" }# list all invoices · read · 1 upstream callcheck { action: "freeagent.invoices.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent
FreeAgent at a glance
- Sign-in
- OAuth 2.0, authorization code. You register your own OAuth app with FreeAgent, an admin signs in once, and you paste the app's client id and secret and the tokens from that sign-in; actionlake renews the access token from then on.
- You provide
access_tokenrefresh_tokenclient_idclient_secret- Limits we pace to
- 120 calls a minute, per connection
- API covered
- FreeAgent API v2
api.freeagent.com/v2 - Built from
- FreeAgent's documentation, read 23 October 2026dev.freeagent.com
- Service file
- Version 1.0.0, signed (Ed25519)
- Cached reads
- 93 of 93 reads, for up to 5 minutes; a write clears what it affects
- Shared entities
- 12, so ask can line FreeAgent up with your other systems
- Data
- Processed and stored in Sydney, Australia. No US region yet
Capabilities
What an AI agent can do in FreeAgent.
203 actions in 48 areas. Every one carries its effect, so a key can allow the reads and hold the rest.
- 93readlook, never change
- 83writecreate and update
- 27destructivewait for a confirmation
Invoices
185 read · 11 write · 2 destructive
List all invoices · Create an invoice · Get a single invoice · Update an invoice
Estimates
164 read · 10 write · 2 destructive
List all estimates · Create an estimate · Get a single estimate · Update an estimate
Credit notes
93 read · 5 write · 1 destructive
List all credit notes · Create a credit note · Get a single credit note · Update a credit note
Timeslips
72 read · 3 write · 2 destructive
List all timeslips · Create a timeslip · Update a timeslip · Get a single timeslip
Users
73 read · 3 write · 1 destructive
List all users · Create a user · Get a single user · Update a user
Corporation tax returns
62 read · 4 write · 0 destructive
List Corporation Tax Returns for a company · Fetch details for a Corporation Tax Return · Mark a Corporation Tax Return as Filed · Mark a Corporation Tax Return as Paid
Expenses
63 read · 2 write · 1 destructive
List all expenses · Create an expense · Get a single expense · Update an expense
Journal sets
63 read · 2 write · 1 destructive
List all journal sets · Create a journal set · Get a single journal set · Update a journal set
40 more areas · 128 actions
- Self assessment returns 6
- Vat returns 6
- Bank accounts 5
- Bank transaction explanations 5
- Bills 5
- Capital asset types 5
- Categories 5
- Contacts 5
- Credit note reconciliations 5
- Price list items 5
- Projects 5
- Properties 5
- Sales tax periods 5
- Tasks 5
- Bank transactions 4
- Final accounts reports 4
- Notes 4
- Payroll 4
- Account locks 3
- Account managers 3
- Company 3
- Estimate items 3
- Accounting transactions 2
- Attachments 2
- Balance sheet 2
- Bank feeds 2
- Capital assets 2
- Cis settings 2
- Hire purchases 2
- Recurring invoices 2
- Stock items 2
- Trial balance 2
- Cashflow 1
- Cis bands 1
- Email addresses 1
- Payroll profiles 1
- Practice 1
- Practice clients 1
- Profit and loss 1
- Sales tax 1
Top actions
The FreeAgent API, shaped for agents.
The ids your agent types, what each does, and the one name it shares with other systems. 74 of FreeAgent's 74 action names are shared with at least one other connector, so an agent learns them once.
| Action | What it does | Effect | Same name in |
|---|---|---|---|
freeagent.invoices.listList all invoices | List all invoices. | read | finance.invoice.list101 connectors |
freeagent.estimates.listList all estimates | List all estimates. | read | finance.quote.list52 connectors |
freeagent.expenses.listList all expenses | List all expenses. | read | finance.expense.list40 connectors |
freeagent.bank_accounts.listList bank accounts | List bank accounts. | read | finance.bank_account.list35 connectors |
freeagent.credit_notes.listList all credit notes | List all credit notes. | read | finance.credit_note.list33 connectors |
freeagent.bills.listList all bills | List all bills. | read | finance.bill.list31 connectors |
freeagent.tasks.listList all tasks | List all tasks. | read | work.task.list122 connectors |
freeagent.users.listList all users | List all users. | read | identity.user.list474 connectors |
freeagent.invoices.createCreate an invoice | Create an invoice. | write | finance.invoice.create74 connectors |
freeagent.estimates.createCreate an estimate | Create an estimate. | write | finance.quote.create52 connectors |
freeagent.expenses.createCreate an expense | Create an expense. | write | finance.expense.create36 connectors |
freeagent.invoices.deleteDelete an invoice | Delete an invoice. | destructive | finance.invoice.delete56 connectors |
Try it
Prompts to paste into Claude.
Each one names the FreeAgent actions it will call, so you know what it reads and what it changes before you send it.
- Readread
Which FreeAgent invoices are more than 30 days overdue? Group them by customer with the total owed.
calls
freeagent.invoices.list - Writewrite
Create an invoice in FreeAgent. Show me exactly what you will send before you save it.
calls
freeagent.invoices.create - Across systemsread
For each customer, how many invoices are in FreeAgent and how many tickets in ConnectWise PSA?
calls
freeagent.invoices.listconnectwise_manage.tickets.list
Across your systems
FreeAgent, joined to the rest of your business.
One ask fetches from FreeAgent and another system, joins the rows on the same customer on our side, and hands your agent the answer, not every row.
For each customer, how many invoices are in FreeAgent and how many tickets in ConnectWise PSA?
freeagent.invoices.list+connectwise_manage.tickets.list, oncrm.company· ConnectWise PSAFor each customer, how many invoices are in FreeAgent and how many tickets in HubSpot CRM?
freeagent.invoices.list+hubspot_crm.tickets.list, oncrm.company· HubSpot CRM
identity.user 517crm.company 227crm.contact 192work.project 116work.task 105finance.invoice 91finance.quote 45work.time_entry 40ask { intent: "for each customer, how many invoices are in FreeAgent and how many tickets in ConnectWise PSA", steps: [ { action: "freeagent.invoices.list", as: "inv", input: {}, limit: 100, max_pages: 5 }, { action: "connectwise_manage.tickets.list", as: "tix", input: {}, limit: 100, max_pages: 5 }, { join: { left: "inv", right: "tix", on: "crm.company", group_by: "inv.company_name", select: ["inv.company_name", "count(inv.id) as invoices", "count(tix.id) as tickets"] } } ]}Governance for FreeAgent
Destructive actions wait for a yes.
27 FreeAgent actions are destructive. These are all of them:
- Delete an invoice
freeagent.invoices.delete - Delete an estimate
freeagent.estimates.delete - Delete an expense
freeagent.expenses.delete - Delete a task
freeagent.tasks.delete - Delete a project
freeagent.projects.delete - Delete a bill
freeagent.bills.delete - Delete a credit note
freeagent.credit_notes.delete - Delete a user
freeagent.users.delete - Delete a bank account
freeagent.bank_accounts.delete - Delete a timeslip
freeagent.timeslips.delete - Delete a contact
freeagent.contacts.delete - Delete a journal set
freeagent.journal_sets.delete - Delete a price list item
freeagent.price_list_items.delete - Delete a bank transaction
freeagent.bank_transactions.delete - Delete a note
freeagent.notes.delete - Delete a category
freeagent.categories.delete - Delete a property
freeagent.properties.delete - Delete a single attachment
freeagent.attachments.delete - Delete the User Account Lock
freeagent.account_locks.delete - Delete an estimate item
freeagent.estimate_items.delete - Delete a sales tax period
freeagent.sales_tax_periods.delete - Delete a capital asset type
freeagent.capital_asset_types.delete - Delete a credit note reconciliation
freeagent.credit_note_reconciliations.delete - Delete a bank transaction explanation
freeagent.bank_transaction_explanations.delete - Stop a Timer
freeagent.timeslips.stop_timer - Delete default additional text
freeagent.invoices.default_additional_text_delete - Delete default additional text
freeagent.estimates.default_additional_text_delete
A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.
Delete an invoice?
intent: the user asked me to delete an invoice
account { op: "keys.create", name: "freeagent-agent", allowed_actions: ["freeagent.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "freeagent.invoices.delete", approver: "[email protected]" }, { match: "freeagent.estimates.delete", approver: "[email protected]" }, { match: "freeagent.expenses.delete", approver: "[email protected]" } ]}Cost
What FreeAgent costs on actionlake.
Every FreeAgent action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call FreeAgent refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
- 1upstream call per actionall 203 FreeAgent actions
- 203actions pageeach page of a long list is one call
- 93reads can be cacheda cache hit costs nothing
- 100,000calls a month, freepaid plans from US$49 a month for 250,000
Action index
Every FreeAgent action.
203 actions by area: the id your agent calls, what it does, and its effect.
Invoices18
freeagent.invoices.convert_to_credit_noteConvert to credit notewritefreeagent.invoices.createCreate an invoicewritefreeagent.invoices.default_additional_text_deleteDelete default additional textdestructivefreeagent.invoices.default_additional_text_getGet default additional textreadfreeagent.invoices.default_additional_text_updateUpdate default additional textwritefreeagent.invoices.deleteDelete an invoicedestructivefreeagent.invoices.duplicateDuplicate an invoicewritefreeagent.invoices.getGet a single invoicereadfreeagent.invoices.get_pdfGet a single invoice as PDFreadfreeagent.invoices.listList all invoicesreadfreeagent.invoices.mark_as_cancelledMark invoice as cancelledwritefreeagent.invoices.mark_as_draftMark invoice as draftwritefreeagent.invoices.mark_as_scheduledMark invoice as scheduledwritefreeagent.invoices.mark_as_sentMark invoice as sentwritefreeagent.invoices.send_emailEmail an invoicewritefreeagent.invoices.take_direct_debit_paymentTake Payment using GoCardless Direct Debit Mandatewritefreeagent.invoices.timelineGet invoice timelinereadfreeagent.invoices.updateUpdate an invoicewrite
Estimates16
freeagent.estimates.convert_to_invoiceConvert estimate to an invoicewritefreeagent.estimates.createCreate an estimatewritefreeagent.estimates.default_additional_text_deleteDelete default additional textdestructivefreeagent.estimates.default_additional_text_getGet default additional textreadfreeagent.estimates.default_additional_text_updateUpdate default additional textwritefreeagent.estimates.deleteDelete an estimatedestructivefreeagent.estimates.duplicateDuplicate an estimatewritefreeagent.estimates.getGet a single estimatereadfreeagent.estimates.get_pdfGet a single estimate as PDFreadfreeagent.estimates.listList all estimatesreadfreeagent.estimates.mark_as_approvedMark estimate as approvedwritefreeagent.estimates.mark_as_draftMark estimate as draftwritefreeagent.estimates.mark_as_rejectedMark estimate as rejectedwritefreeagent.estimates.mark_as_sentMark estimate as sentwritefreeagent.estimates.send_emailEmail an estimatewritefreeagent.estimates.updateUpdate an estimatewrite
Credit notes9
freeagent.credit_notes.createCreate a credit notewritefreeagent.credit_notes.deleteDelete a credit notedestructivefreeagent.credit_notes.getGet a single credit notereadfreeagent.credit_notes.get_pdfGet a single credit note as PDFreadfreeagent.credit_notes.listList all credit notesreadfreeagent.credit_notes.mark_as_draftMark credit note as draftwritefreeagent.credit_notes.mark_as_sentMark credit note as sentwritefreeagent.credit_notes.send_emailEmail a credit notewritefreeagent.credit_notes.updateUpdate a credit notewrite
Timeslips7
freeagent.timeslips.createCreate a timeslipwritefreeagent.timeslips.deleteDelete a timeslipdestructivefreeagent.timeslips.getGet a single timeslipreadfreeagent.timeslips.listList all timeslipsreadfreeagent.timeslips.start_timerStart a Timerwritefreeagent.timeslips.stop_timerStop a Timerdestructivefreeagent.timeslips.updateUpdate a timeslipwrite
Users7
freeagent.users.createCreate a userwritefreeagent.users.deleteDelete a userdestructivefreeagent.users.getGet a single userreadfreeagent.users.listList all usersreadfreeagent.users.meGet the personal profile of the authorised userreadfreeagent.users.updateUpdate a userwritefreeagent.users.update_meUpdate personal profilewrite
Corporation tax returns6
freeagent.corporation_tax_returns.getFetch details for a Corporation Tax Returnreadfreeagent.corporation_tax_returns.listList Corporation Tax Returns for a companyreadfreeagent.corporation_tax_returns.mark_as_filedMark a Corporation Tax Return as Filedwritefreeagent.corporation_tax_returns.mark_as_paidMark a Corporation Tax Return as Paidwritefreeagent.corporation_tax_returns.mark_as_unfiledMark a Corporation Tax Return as Unfiledwritefreeagent.corporation_tax_returns.mark_as_unpaidMark a Corporation Tax Return as Unpaidwrite
Expenses6
freeagent.expenses.createCreate an expensewritefreeagent.expenses.deleteDelete an expensedestructivefreeagent.expenses.getGet a single expensereadfreeagent.expenses.listList all expensesreadfreeagent.expenses.mileage_settingsGet mileage settingsreadfreeagent.expenses.updateUpdate an expensewrite
Journal sets6
freeagent.journal_sets.createCreate a journal setwritefreeagent.journal_sets.deleteDelete a journal setdestructivefreeagent.journal_sets.getGet a single journal setreadfreeagent.journal_sets.listList all journal setsreadfreeagent.journal_sets.opening_balancesGet the Opening Balancesreadfreeagent.journal_sets.updateUpdate a journal setwrite
Self assessment returns6
freeagent.self_assessment_returns.getFetch details for an Income Tax Returnreadfreeagent.self_assessment_returns.listList Income Tax Returns for a Userreadfreeagent.self_assessment_returns.mark_as_filedMark an Income Tax Return as Filedwritefreeagent.self_assessment_returns.mark_as_unfiledMark an Income Tax Return as Unfiledwritefreeagent.self_assessment_returns.mark_payment_as_paidMark an Income Tax Return Payment as Paidwritefreeagent.self_assessment_returns.mark_payment_as_unpaidMark an Income Tax Return Payment as Unpaidwrite
Vat returns6
freeagent.vat_returns.getFetch details for a VAT Returnreadfreeagent.vat_returns.listList VAT Returns for a Companyreadfreeagent.vat_returns.mark_as_filedMark a VAT Return as Filedwritefreeagent.vat_returns.mark_as_unfiledMark a VAT Return as Unfiledwritefreeagent.vat_returns.mark_payment_as_paidMark a VAT Return Payment as Paidwritefreeagent.vat_returns.mark_payment_as_unpaidMark a VAT Return Payment as Unpaidwrite
Bank accounts5
freeagent.bank_accounts.createCreate a bank accountwritefreeagent.bank_accounts.deleteDelete a bank accountdestructivefreeagent.bank_accounts.getGet a single bank accountreadfreeagent.bank_accounts.listList bank accountsreadfreeagent.bank_accounts.updateUpdate a bank accountwrite
Bank transaction explanations5
freeagent.bank_transaction_explanations.createCreate a bank transaction explanationwritefreeagent.bank_transaction_explanations.deleteDelete a bank transaction explanationdestructivefreeagent.bank_transaction_explanations.getGet a single bank transaction explanationreadfreeagent.bank_transaction_explanations.listList all bank transaction explanationsreadfreeagent.bank_transaction_explanations.updateUpdate a bank transaction explanationwrite
Bills5
freeagent.bills.createCreate a billwritefreeagent.bills.deleteDelete a billdestructivefreeagent.bills.getGet a single billreadfreeagent.bills.listList all billsreadfreeagent.bills.updateUpdate a billwrite
Capital asset types5
freeagent.capital_asset_types.createCreate a capital asset typewritefreeagent.capital_asset_types.deleteDelete a capital asset typedestructivefreeagent.capital_asset_types.getGet a single capital asset typereadfreeagent.capital_asset_types.listList all capital asset typesreadfreeagent.capital_asset_types.updateUpdate a capital asset typewrite
Categories5
freeagent.categories.createCreate a categorywritefreeagent.categories.deleteDelete a categorydestructivefreeagent.categories.getGet a single categoryreadfreeagent.categories.listList all categoriesreadfreeagent.categories.updateUpdate a categorywrite
Contacts5
freeagent.contacts.createCreate a contactwritefreeagent.contacts.deleteDelete a contactdestructivefreeagent.contacts.getGet a single contactreadfreeagent.contacts.listList all contactsreadfreeagent.contacts.updateUpdate a contactwrite
Credit note reconciliations5
freeagent.credit_note_reconciliations.createCreate a credit note reconciliationwritefreeagent.credit_note_reconciliations.deleteDelete a credit note reconciliationdestructivefreeagent.credit_note_reconciliations.getGet a single credit note reconciliationreadfreeagent.credit_note_reconciliations.listList all credit note reconciliationsreadfreeagent.credit_note_reconciliations.updateUpdate a credit note reconciliationwrite
Price list items5
freeagent.price_list_items.createCreate a price list itemwritefreeagent.price_list_items.deleteDelete a price list itemdestructivefreeagent.price_list_items.getGet a single price list itemreadfreeagent.price_list_items.listList all price list itemsreadfreeagent.price_list_items.updateUpdate a price list itemwrite
Projects5
freeagent.projects.createCreate a projectwritefreeagent.projects.deleteDelete a projectdestructivefreeagent.projects.getGet a single projectreadfreeagent.projects.listList all projectsreadfreeagent.projects.updateUpdate a projectwrite
Properties5
freeagent.properties.createCreate a propertywritefreeagent.properties.deleteDelete a propertydestructivefreeagent.properties.getGet a single propertyreadfreeagent.properties.listList all propertiesreadfreeagent.properties.updateUpdate a propertywrite
Sales tax periods5
freeagent.sales_tax_periods.createCreate a sales tax periodwritefreeagent.sales_tax_periods.deleteDelete a sales tax perioddestructivefreeagent.sales_tax_periods.getGet a single sales tax periodreadfreeagent.sales_tax_periods.listList all sales tax periods for a companyreadfreeagent.sales_tax_periods.updateUpdate a sales tax periodwrite
Tasks5
freeagent.tasks.createCreate a task under a projectwritefreeagent.tasks.deleteDelete a taskdestructivefreeagent.tasks.getGet a single taskreadfreeagent.tasks.listList all tasksreadfreeagent.tasks.updateUpdate a taskwrite
Bank transactions4
freeagent.bank_transactions.deleteDelete a bank transactiondestructivefreeagent.bank_transactions.getGet a single bank transactionreadfreeagent.bank_transactions.listList bank transactions in a bank accountreadfreeagent.bank_transactions.upload_statementUpload a bank statementwrite
Final accounts reports4
freeagent.final_accounts_reports.getFetch details for a Final Accounts Reportreadfreeagent.final_accounts_reports.listList Final Accounts Reports for a companyreadfreeagent.final_accounts_reports.mark_as_filedMark a Final Accounts Report as Filedwritefreeagent.final_accounts_reports.mark_as_unfiledMark a Final Accounts Report as Unfiledwrite
Notes4
freeagent.notes.createCreate a note for a contact or projectwritefreeagent.notes.deleteDelete a notedestructivefreeagent.notes.getGet a single notereadfreeagent.notes.updateUpdate a notewrite
Payroll4
freeagent.payroll.get_periodList all payslips for a given periodreadfreeagent.payroll.list_periodsList all periods for a given tax yearreadfreeagent.payroll.mark_payment_as_paidMark a payment as paidwritefreeagent.payroll.mark_payment_as_unpaidMark a payment as unpaidwrite
Account locks3
freeagent.account_locks.deleteDelete the User Account Lockdestructivefreeagent.account_locks.listList Account Locks for a companyreadfreeagent.account_locks.upsertCreate or Update the User Account Lockwrite
Account managers3
freeagent.account_managers.getGet details of a single account managerreadfreeagent.account_managers.listList account managersreadfreeagent.account_managers.meGet the current account managerread
Company3
freeagent.company.business_categoriesList all business categoriesreadfreeagent.company.getGeneral company informationreadfreeagent.company.tax_timelineInformation about upcoming tax eventsread
Estimate items3
freeagent.estimate_items.createCreate an estimate itemwritefreeagent.estimate_items.deleteDelete an estimate itemdestructivefreeagent.estimate_items.updateUpdate an estimate itemwrite
Accounting transactions2
freeagent.accounting_transactions.getGet a single transactionreadfreeagent.accounting_transactions.listList all transactionsread
Attachments2
freeagent.attachments.deleteDelete a single attachmentdestructivefreeagent.attachments.getShow a single attachmentread
Balance sheet2
freeagent.balance_sheet.getGet the balance sheetreadfreeagent.balance_sheet.opening_balancesGet the opening balancesread
Bank feeds2
freeagent.bank_feeds.getReading an API Bank Feedreadfreeagent.bank_feeds.listReading the list of bank feeds for a companyread
Capital assets2
freeagent.capital_assets.getGet a single capital assetreadfreeagent.capital_assets.listList all capital assetsread
Cis settings2
freeagent.cis_settings.getGet CIS settingsreadfreeagent.cis_settings.updateUpdate CIS settingswrite
Hire purchases2
freeagent.hire_purchases.getGet a single hire purchasereadfreeagent.hire_purchases.listList all hire purchasesread
Recurring invoices2
freeagent.recurring_invoices.getGet a single recurring invoicereadfreeagent.recurring_invoices.listList all recurring invoicesread
Stock items2
freeagent.stock_items.getGet a single Stock Itemreadfreeagent.stock_items.listList all Stock Itemsread
Trial balance2
freeagent.trial_balance.opening_balancesGet the opening balancesreadfreeagent.trial_balance.summaryGet the trial balance summaryread
Cashflow1
freeagent.cashflow.getCashflow summary for a given date rangeread
Cis bands1
freeagent.cis_bands.listList all CIS bands for a companyread
Email addresses1
freeagent.email_addresses.listGet a list of verified sender email addressesread
Payroll profiles1
freeagent.payroll_profiles.listList payroll profiles for a tax yearread
Practice1
freeagent.practice.getGet details of accountancy practiceread
Practice clients1
freeagent.practice_clients.listList clientsread
Profit and loss1
freeagent.profit_and_loss.summaryGet the P&L summaryread
Sales tax1
freeagent.sales_tax.ec_moss_ratesEC VAT MOSSread
Questions
The FreeAgent MCP server, answered.
Is there a FreeAgent MCP server for Claude?
Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 203 FreeAgent actions across invoices, estimates, credit notes and timeslips, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by FreeAgent.
What do I need to connect FreeAgent?
Your own FreeAgent OAuth app, registered with FreeAgent (its client id and client secret), and the access and refresh tokens from one admin sign-in. actionlake has no FreeAgent app of its own, so this is not a one-step consent. actionlake renews the access token as it expires. The free call account { op: "connections.requirements", service: "freeagent" } lists exactly what to paste.
Can an AI agent delete or change things in FreeAgent?
Only if its key allows it, and only with an explicit confirmation. 27 FreeAgent actions are destructive, including delete an invoice, delete an estimate and delete an expense. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.
Will an AI agent use up my FreeAgent API limit?
actionlake paces every call to the limits in the FreeAgent service file: 120 calls a minute per connection. Repeated reads are answered from cache (93 FreeAgent actions can be), which never reaches FreeAgent.
What does a FreeAgent action cost?
One upstream call, the only unit actionlake bills. A list that pages bills one call per page (203 FreeAgent actions page). Cache hits, searches, dry runs and calls FreeAgent refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
Which FreeAgent API does it cover?
The FreeAgent API v2 at api.freeagent.com/v2. It is built from FreeAgent's documentation as read on 23 October 2026. 203 actions in 48 areas, each one in the signed service file (version 1.0.0).
Can I combine FreeAgent with my other systems?
Yes. ask joins FreeAgent to ConnectWise PSA or HubSpot CRM on the same customer and returns the answer rather than every row. FreeAgent maps crm.company, which 227 other connectors also map.
Does actionlake keep my FreeAgent data, and where?
actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your FreeAgent credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.
Which AI clients can use it?
Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.
Give your agent FreeAgent today.
Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.