FreeAgent MCP by usefulapi
io.usefulapi/freeagentusefulapi.iostreamable-httpv1.33.5Scanned
Read FreeAgent contacts, invoices, bills, banking and reports; add contacts, draft invoices, time.
20 tools: 4 can delete or cancel things and 16 only read.
- Reads private data · 6
- Reads text others write · 3
- Can send data out · 0
- 1 finding
The remote endpoint did not answer the last look. Remote posture
Anlyon alternative
4 of these tools change something. Run those as governed actions.
Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.
Anlyon Radar does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.
Import an OpenAPI spec →What the FreeAgent MCP by usefulapi can do
The FreeAgent MCP by usefulapi is published by usefulapi.io, a domain the MCP Registry verified. It has 20 tools. It can delete or cancel things (4 tools: freeagent_create_contact, freeagent_update_contact, freeagent_create_draft_invoice and freeagent_create_timeslip). 16 tools only read.
6 tools read private data (freeagent_get_company, freeagent_list_contacts, freeagent_get_contact and 3 more); 3 tools bring in text other people can write (freeagent_get_current_user, freeagent_get_contact and freeagent_get_invoice).
The fixed checks matched 1 finding (credentials-mention). Each one comes with the text it matched.
Last scanned Oct 25, 2026, version 1.33.5.
Tools
Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.
20 tools
Deletes or cancels 4Claude Code: deny
freeagent_create_contactCreate a client or supplier contact.No findings
Why it is in this group
- The name "freeagent_create_contact" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Create a client or supplier contact. Give either organisation_name, or first_name and last_name. FreeAgent: POST /v2/contacts.
Annotations the server declares
- title: Create a contact
- destructiveHint: true
freeagent_create_draft_invoiceCreate a sales invoice in DRAFT status.No findings
Why it is in this group
- The name "freeagent_create_draft_invoice" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Create a sales invoice in DRAFT status. Nothing is sent to the customer and nothing is posted as income until it is marked sent in FreeAgent; a draft can be edited or discarded there. FreeAgent: POST /v2/invoices.
Annotations the server declares
- title: Create a draft invoice
- destructiveHint: true
freeagent_create_timeslipLog time against a project task for a user.No findings
Why it is in this group
- The name "freeagent_create_timeslip" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Log time against a project task for a user. Get the user from freeagent_get_current_user and the task from freeagent_list_tasks. Editable or removable in FreeAgent afterwards. FreeAgent: POST /v2/timeslips.
Annotations the server declares
- title: Log a timeslip
- destructiveHint: true
freeagent_update_contactUpdate fields on an existing contact; only the fields you pass change.No findings
Why it is in this group
- The name "freeagent_update_contact" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Update fields on an existing contact; only the fields you pass change. status=Hidden hides it (reversible with Active). FreeAgent: PUT /v2/contacts/:id.
Annotations the server declares
- title: Update a contact
- destructiveHint: true
Only reads 16Show 16 read-only tools
freeagent_get_balance_sheetBalance sheet — capital and current assets, liabilities and owners' equity — as at a date (default today).No findings
Why it is in this group
- The name "freeagent_get_balance_sheet" says "get": a word for reading.
Description, as the server wrote it Balance sheet — capital and current assets, liabilities and owners' equity — as at a date (default today). FreeAgent: GET /v2/accounting/balance_sheet.
Annotations the server declares
- title: Get the balance sheet
- readOnlyHint: true
freeagent_get_companyFetch the FreeAgent company these credentials belong to — name, type (e.g.Reads private data1 finding
Why it is in this group
- The name "freeagent_get_company" says "get": a word for reading.
What it can reach
- private-dataThe description's first sentence says "fetch" and "credential": it reads secrets.
Findings
- Info
The description mentions "credentials".
What this check looks forMatched text
description: "Fetch the FreeAgent company these credentials belong to — name, type (e.g. UkLimitedC..."
Description, as the server wrote it Fetch the FreeAgent company these credentials belong to — name, type (e.g. UkLimitedCompany), currency, start date and VAT registration status. A cheap way to confirm the setup works. FreeAgent: GET /v2/company.
Annotations the server declares
- title: Get the company
- readOnlyHint: true
freeagent_get_contactFetch a single contact by id or URL.Reads private dataReads text others writeNo findings
Why it is in this group
- The name "freeagent_get_contact" says "get": a word for reading.
What it can reach
- private-dataThe name "freeagent_get_contact" says "get" and "contact": it reads contacts.
- private-dataThe description's first sentence says "fetch" and "contact": it reads contacts.
- untrusted-inputThe description's first sentence says "fetch" and "url": it reads web pages, which anyone can write.
Description, as the server wrote it Fetch a single contact by id or URL. FreeAgent: GET /v2/contacts/:id.
Annotations the server declares
- title: Get one contact
- readOnlyHint: true
freeagent_get_current_userFetch the FreeAgent user the token acts as, including their URL (needed for freeagent_create_timeslip) and permission level.Reads text others writeNo findings
Why it is in this group
- The name "freeagent_get_current_user" says "get": a word for reading.
What it can reach
- untrusted-inputThe description's first sentence says "fetch" and "url": it reads web pages, which anyone can write.
Description, as the server wrote it Fetch the FreeAgent user the token acts as, including their URL (needed for freeagent_create_timeslip) and permission level. FreeAgent: GET /v2/users/me.
Annotations the server declares
- title: Get the current user
- readOnlyHint: true
freeagent_get_invoiceFetch a single invoice by id or URL, with its line items, totals, due and paid values.Reads text others writeNo findings
Why it is in this group
- The name "freeagent_get_invoice" says "get": a word for reading.
What it can reach
- untrusted-inputThe description's first sentence says "fetch" and "url": it reads web pages, which anyone can write.
Description, as the server wrote it Fetch a single invoice by id or URL, with its line items, totals, due and paid values. FreeAgent: GET /v2/invoices/:id.
Annotations the server declares
- title: Get one invoice
- readOnlyHint: true
freeagent_get_profit_and_lossProfit and loss summary — income, expenses, operating and retained profit — for a date range or an accounting period (defaults to the current year to date).No findings
Why it is in this group
- The name "freeagent_get_profit_and_loss" says "get": a word for reading.
Description, as the server wrote it Profit and loss summary — income, expenses, operating and retained profit — for a date range or an accounting period (defaults to the current year to date). FreeAgent: GET /v2/accounting/profit_and_loss/summary.
Annotations the server declares
- title: Get profit and loss
- readOnlyHint: true
freeagent_get_tax_timelineList upcoming tax deadlines and amounts due — VAT returns, corporation tax, self assessment and so on.No findings
Why it is in this group
- The name "freeagent_get_tax_timeline" says "get": a word for reading.
Description, as the server wrote it List upcoming tax deadlines and amounts due — VAT returns, corporation tax, self assessment and so on. FreeAgent: GET /v2/company/tax_timeline.
Annotations the server declares
- title: Get the tax timeline
- readOnlyHint: true
freeagent_list_bank_accountsList bank, credit-card and PayPal accounts with their current balances.No findings
Why it is in this group
- The name "freeagent_list_bank_accounts" says "list": a word for reading.
Description, as the server wrote it List bank, credit-card and PayPal accounts with their current balances. Use an account's URL with freeagent_list_bank_transactions. FreeAgent: GET /v2/bank_accounts.
Annotations the server declares
- title: List bank accounts
- readOnlyHint: true
freeagent_list_bank_transactionsList the transactions on one bank account, e.g.No findings
Why it is in this group
- The name "freeagent_list_bank_transactions" says "list": a word for reading.
Description, as the server wrote it List the transactions on one bank account, e.g. view=unexplained for what still needs reconciling. FreeAgent: GET /v2/bank_transactions?bank_account=….
Annotations the server declares
- title: List bank transactions
- readOnlyHint: true
freeagent_list_billsList supplier bills (purchases), optionally by date range, contact or project, filtered by status.Reads private dataNo findings
Why it is in this group
- The name "freeagent_list_bills" says "list": a word for reading.
What it can reach
- private-dataThe description's first sentence says "list" and "contact": it reads contacts.
Description, as the server wrote it List supplier bills (purchases), optionally by date range, contact or project, filtered by status. FreeAgent: GET /v2/bills.
Annotations the server declares
- title: List bills
- readOnlyHint: true
freeagent_list_contactsList contacts (clients and suppliers), with their account balance.Reads private dataNo findings
Why it is in this group
- The name "freeagent_list_contacts" says "list": a word for reading.
What it can reach
- private-dataThe name "freeagent_list_contacts" says "list" and "contact": it reads contacts.
- private-dataThe description's first sentence says "list" and "contact": it reads contacts.
Description, as the server wrote it List contacts (clients and suppliers), with their account balance. FreeAgent: GET /v2/contacts.
Annotations the server declares
- title: List contacts
- readOnlyHint: true
freeagent_list_expensesList expense claims (out-of-pocket spending and mileage), optionally by date range or project.No findings
Why it is in this group
- The name "freeagent_list_expenses" says "list": a word for reading.
Description, as the server wrote it List expense claims (out-of-pocket spending and mileage), optionally by date range or project. FreeAgent: GET /v2/expenses.
Annotations the server declares
- title: List expenses
- readOnlyHint: true
freeagent_list_invoicesList sales invoices, optionally for one contact or project, filtered by status.Reads private dataNo findings
Why it is in this group
- The name "freeagent_list_invoices" says "list": a word for reading.
What it can reach
- private-dataThe description's first sentence says "list" and "contact": it reads contacts.
Description, as the server wrote it List sales invoices, optionally for one contact or project, filtered by status. FreeAgent: GET /v2/invoices.
Annotations the server declares
- title: List invoices
- readOnlyHint: true
freeagent_list_projectsList projects, optionally for one contact.Reads private dataNo findings
Why it is in this group
- The name "freeagent_list_projects" says "list": a word for reading.
What it can reach
- private-dataThe description's first sentence says "list" and "contact": it reads contacts.
Description, as the server wrote it List projects, optionally for one contact. FreeAgent: GET /v2/projects.
Annotations the server declares
- title: List projects
- readOnlyHint: true
freeagent_list_tasksList project tasks with their billing rates, optionally for one project.No findings
Why it is in this group
- The name "freeagent_list_tasks" says "list": a word for reading.
Description, as the server wrote it List project tasks with their billing rates, optionally for one project. A task's URL is needed for freeagent_create_timeslip. FreeAgent: GET /v2/tasks.
Annotations the server declares
- title: List tasks
- readOnlyHint: true
freeagent_list_timeslipsList logged time, optionally by date range, user, task or project; view=unbilled for time not yet invoiced.No findings
Why it is in this group
- The name "freeagent_list_timeslips" says "list": a word for reading.
Description, as the server wrote it List logged time, optionally by date range, user, task or project; view=unbilled for time not yet invoiced. FreeAgent: GET /v2/timeslips.
Annotations the server declares
- title: List timeslips
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged outbound.
- Reads private data6
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write3
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out0
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Nov 20, 2026, 19:35 UTC, unchanged since Oct 29, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- no
- HTTP status of an anonymous initialize
- not observed
- tools/list served without credentials
- no
- Tools that change things, listed without credentials
- 0
- Protocol version
- not observed
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- not observed
- RFC 9728 protected resource metadata
- not observed
- Authorization servers
- not observed
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- not observed
- Client ID metadata documents
- not observed
The probe stopped: The server redirected a POST to a different request.
Posture changes
- Oct 29, 2026
- Reachable: yes to no
- HTTP status of an anonymous initialize: 200 to none
- tools/list served without credentials: yes to no
- Tools that change things, listed without credentials: 4 to 0
- Protocol version: 2025-06-18 to none
- RFC 9728 protected resource metadata: https://freeagent.usefulapi.io/.well-known/oauth-protected-resource/mcp to none
- Authorization servers: https://freeagent.usefulapi.io to none
- Dynamic client registration: yes to not observed
- Client ID metadata documents: no to not observed
Findings
Matches of fixed checks, with the text they matched.
The description mentions "credentials".
What this check looks forMatched text
description: "Fetch the FreeAgent company these credentials belong to — name, type (e.g. UkLimitedC..."
History
Changes to its tool definitions and to its remote endpoint, newest first.
PostureRemote posture changed. Reachable: yes -> no; HTTP status of an anonymous initialize: 200 -> none; tools/list served without credentials: yes -> no (and 6 more).View diff
- Reachable: yes to no
- HTTP status of an anonymous initialize: 200 to none
- tools/list served without credentials: yes to no
- Tools that change things, listed without credentials: 4 to 0
- Protocol version: 2025-06-18 to none
- RFC 9728 protected resource metadata: https://freeagent.usefulapi.io/.well-known/oauth-protected-resource/mcp to none
- Authorization servers: https://freeagent.usefulapi.io to none
- Dynamic client registration: yes to not observed
- Client ID metadata documents: no to not observed
Install
Pinned to version 1.33.5. Values in angle brackets are yours to fill in.
claude mcp add --transport http freeagent https://freeagent.usefulapi.io/mcpclaude mcp add --transport http freeagent https://freeagent.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__freeagent__freeagent_get_company",
"mcp__freeagent__freeagent_get_current_user",
"mcp__freeagent__freeagent_get_tax_timeline",
"mcp__freeagent__freeagent_list_contacts",
"mcp__freeagent__freeagent_get_contact",
"mcp__freeagent__freeagent_list_invoices",
"mcp__freeagent__freeagent_get_invoice",
"mcp__freeagent__freeagent_list_bills",
"mcp__freeagent__freeagent_list_expenses",
"mcp__freeagent__freeagent_list_bank_accounts",
"mcp__freeagent__freeagent_list_bank_transactions",
"mcp__freeagent__freeagent_list_projects",
"mcp__freeagent__freeagent_list_tasks",
"mcp__freeagent__freeagent_list_timeslips",
"mcp__freeagent__freeagent_get_profit_and_loss",
"mcp__freeagent__freeagent_get_balance_sheet"
],
"ask": [],
"deny": [
"mcp__freeagent__freeagent_create_contact",
"mcp__freeagent__freeagent_update_contact",
"mcp__freeagent__freeagent_create_draft_invoice",
"mcp__freeagent__freeagent_create_timeslip"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as freeagent. Review it before you use it.
Capability tags behind 8 rules
- mcp__freeagent__freeagent_get_company private-data
- mcp__freeagent__freeagent_get_current_user untrusted-input
- mcp__freeagent__freeagent_list_contacts private-data
- mcp__freeagent__freeagent_get_contact private-data, untrusted-input
- mcp__freeagent__freeagent_list_invoices private-data
- mcp__freeagent__freeagent_get_invoice untrusted-input
- mcp__freeagent__freeagent_list_bills private-data
- mcp__freeagent__freeagent_list_projects private-data
Pin
Keep the decision: fail CI when the tools change, follow every change, or show a badge.
Pin in CI
Fail a build when the tools you reviewed are not the tools the server serves today.
curl -s "https://radar.anlyon.com/api/v1/servers/io.usefulapi/freeagent/verify?hash=402d8d15896f873e064768355c1721e62fc4046886f8754c57175169f648f649" | jq -e '.changed == false'Pinned hash 402d8d15896f, from Oct 25, 2026, 23:20 UTC.
Watch
Get told when its tools change: a new tool, a new description, a new class.
https://radar.anlyon.com/servers/io.usefulapi/freeagent/changes.xmlAn Atom feed. Works in any feed reader or Slack's RSS app.
Badge
[](https://radar.anlyon.com/servers/io.usefulapi/freeagent)Source: MCP Registry · repository. Synced Nov 20, 2026, 20:18 UTC.
FreeAgent MCP by usefulapi: questions and answers
Answered from the scan above, not from the publisher's description.
Is the FreeAgent MCP by usefulapi safe?
- No scan can promise that. What its definitions show: 20 tools, 4 of which can change, send or delete something, and 1 finding from fixed checks. Allow the reads, ask before each change, and deny the deletes; the permissions block on this page does that.
Can the FreeAgent MCP by usefulapi delete data?
- Yes. 4 tools can delete, cancel or revoke something: freeagent_create_contact, freeagent_update_contact, freeagent_create_draft_invoice and freeagent_create_timeslip.
Can the FreeAgent MCP by usefulapi do things that cannot be undone?
- No tool is classed as irreversible: none of them sends, pays, publishes or merges, going by their definitions.
What tools does the FreeAgent MCP by usefulapi have?
- 20 tools: 4 destructive, 16 read. freeagent_create_contact, freeagent_update_contact, freeagent_create_draft_invoice, freeagent_create_timeslip, freeagent_get_company, freeagent_get_current_user, freeagent_get_tax_timeline, freeagent_list_contacts and 12 more.
Does the FreeAgent MCP by usefulapi need sign-in or OAuth?
- Its remote endpoint did not answer the last anonymous look.
Does the FreeAgent MCP by usefulapi send data to outside services?
- None of its tools sends, posts or publishes, or takes a recipient, channel or URL.
Has the FreeAgent MCP by usefulapi changed its tools?
- Not since Anlyon Radar started tracking it. Last scanned Oct 25, 2026.