FreeAgent MCP by usefulapi
REMOTE · FREEAGENT.USEFULAPI.IO
Read FreeAgent contacts, invoices, bills, banking and reports; add contacts, draft invoices, time.
Available components
Last scanned (5 hours ago)
Scores higher than 4% of remote servers
Reachable. Last reached 7 Nov 2026.
Category Finance and Payments
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security46
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not yet verified: we couldn't confirm whether this endpoint requires it. View diagnostics → Unverified
- HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability0
- Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly. See how to fix → View diagnostics → Fail
Schema Quality & AI Usability0
- Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.Unverified
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage0
- Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.Unverified
Tool Safety0
- Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.Unverified
Capabilities0
- Capabilities not yet verified: we couldn't read the endpoint's capabilities.Unverified
Unverified: 5 categories
Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.
Checks we ran (4)
- TLS certificate
- HSTS header
- DNSSEC
- Transport
Checks we could not complete (7)
These are gaps on our side, not findings about this hosted endpoint. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Authorization in Endpoint SecurityAuthorisation not yet verified: we couldn't confirm whether this endpoint requires it.
- HTTPS in Endpoint SecurityHTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
- Schema quality in Schema Quality & AI Usability (scores 0 for this)Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.
- Stability in Stability & Change Management (scores 0 for this)Stability not yet verified: not enough scan history yet (needs a 30-day window).
- Tool coverage in Tool Coverage (scores 0 for this)Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- Tool safety in Tool Safety (scores 0 for this)Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- Capabilities in Capabilities (scores 0 for this)Capabilities not yet verified: we couldn't read the endpoint's capabilities.
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 6 Nov 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 2 Nov 26 −58
- Endpoint reachability: reachable → not serving MCP ▼ security
- Stability: 0.80 → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Schema quality: 100 → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- 1 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 77 to 80. That category is still filling its 30-day observation window: 23 days of observed history at the previous scan, 24 at this one. The score rises as the window fills, whether or not the server changes.
- 31 Oct 26 +3
- Authorization: partial → pass ▲ security
- MCP protocol: fail → pass ▲ functional
- New prompt “check_unbilled_time_and_draft_an_invoice” functional
- New prompt “check_upcoming_tax_deadlines_and_amounts_due” functional
- New prompt “find_bank_transactions_that_still_need_explaining” functional
- New prompt “find_overdue_sales_invoices_and_who_owes_you” functional
- New prompt “log_time_on_a_project_task” functional
- New prompt “review_profit_and_loss_and_the_balance_sheet” functional
- MCP protocol version: 2025-06-18 → 2025-11-25 functional
- Server version: 1.24.0 → 1.26.0 functional
- Server version: 1.23.0 → 1.24.0 functional
- Server version: 1.22.2 → 1.23.0 functional
- 30 Oct 26 0
- Server version: 1.22.1 → 1.22.2 functional
- Server version: 1.22.0 → 1.22.1 functional
- 29 Oct 26 +1
- Server version: 1.21.0 → 1.22.0 functional
- Server version: 1.20.0 → 1.21.0 functional
- 28 Oct 26 0
- Server version: 1.18.0 → 1.20.0 functional
- 27 Oct 26 +1
- Server version: 1.17.0 → 1.18.0 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 7 Nov 2026 · Probed https://freeagent.usefulapi.io/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=usefulapi.io | CN=WE1,O=Google Trust Services,C=US | 13 Sept 2026 | 12 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | d9be3287b0fde9630e825ba1f79bff3f |
| SANs: usefulapi.io, *.usefulapi.io | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of freeagent.usefulapi.io. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| io. | DS published | 38690 | 8 | Verified |
| usefulapi.io. | No DS | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Inconclusive
We could not reach the endpoint well enough to judge its authorisation posture.
| Result | Inconclusive |
|---|---|
| HTTP status | 302 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://freeagent.usefulapi.io/mcp | Redirected | 302 | https://usefulapi.io/freeagent/ |
| http (plaintext) | http://freeagent.usefulapi.io/mcp | Inconclusive | 302 | http://freeagent.usefulapi.io/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
freeagent_create_contact Create a contact ~279
Create a client or supplier contact. Give either organisation_name, or first_name and last_name. FreeAgent: POST /v2/contacts.
| Name | Type | Req | Description |
|---|---|---|---|
| address1 | string | – | Address line 1. |
| address2 | string | – | Address line 2. |
| address3 | string | – | Address line 3. |
| billing_email | string | – | Email address invoices are sent to. |
| charge_sales_tax | string | – | Whether to charge VAT/sales tax. |
| contact_name_on_invoices | boolean | – | Show the contact's name on invoices. |
| country | string | – | Country name, e.g. United Kingdom. |
| default_payment_terms_in_days | integer | – | Default payment terms for invoices to this contact. |
| string | – | Email address. | |
| first_name | string | – | Contact first name. |
| last_name | string | – | Contact last name. |
| locale | string | – | Invoice language locale, e.g. en. |
| mobile | string | – | Mobile number. |
| organisation_name | string | – | Organisation / company name. |
| phone_number | string | – | Phone number. |
| postcode | string | – | Postcode. |
| region | string | – | Region / county. |
| sales_tax_registration_number | string | – | The contact's VAT registration number. |
| town | string | – | Town or city. |
No output schema declared.
No examples provided.
freeagent_create_draft_invoice Create a draft invoice ~259
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.
| Name | Type | Req | Description |
|---|---|---|---|
| comments | string | – | Comments printed on the invoice. |
| contact | string | yes | The contact being invoiced's numeric id or full FreeAgent URL. |
| currency | string | – | ISO currency code, e.g. GBP (defaults to the company currency). |
| dated_on | string | yes | Invoice date (YYYY-MM-DD). |
| discount_percent | number | – | Whole-invoice discount percentage. |
| due_on | string | – | Explicit due date, if not derived from payment terms (YYYY-MM-DD). |
| exchange_rate | number | – | Exchange rate for a foreign-currency invoice. |
| invoice_items | array | yes | The invoice lines. |
| payment_terms_in_days | integer | yes | Payment terms in days; 0 = due on receipt. |
| po_reference | string | – | The customer's purchase-order reference. |
| project | string | – | The project's numeric id or full FreeAgent URL. |
| reference | string | – | Invoice reference/number; omit to use the next in sequence. |
No output schema declared.
No examples provided.
freeagent_create_timeslip Log a timeslip ~155
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.
| Name | Type | Req | Description |
|---|---|---|---|
| comment | string | – | What the time was spent on. |
| dated_on | string | yes | Day the work was done (YYYY-MM-DD). |
| hours | number | yes | Hours worked, e.g. 1.5. |
| project | string | yes | The project's numeric id or full FreeAgent URL. |
| task | string | yes | The task's numeric id or full FreeAgent URL. |
| user | string | yes | The user's numeric id or full FreeAgent URL. |
No output schema declared.
No examples provided.
freeagent_get_balance_sheet Get the balance sheet ~62
Balance sheet — capital and current assets, liabilities and owners' equity — as at a date (default today). FreeAgent: GET /v2/accounting/balance_sheet.
| Name | Type | Req | Description |
|---|---|---|---|
| as_at_date | string | – | Balance sheet date (YYYY-MM-DD). |
No output schema declared.
No examples provided.
freeagent_get_company Get the company ~58
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
freeagent_get_contact Get one contact ~48
Fetch a single contact by id or URL. FreeAgent: GET /v2/contacts/:id.
| Name | Type | Req | Description |
|---|---|---|---|
| contact | string | yes | The contact's numeric id or full FreeAgent URL. |
No output schema declared.
No examples provided.
freeagent_get_current_user Get the current user ~47
Fetch the FreeAgent user the token acts as, including their URL (needed for freeagent_create_timeslip) and permission level. FreeAgent: GET /v2/users/me.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
freeagent_get_invoice Get one invoice ~60
Fetch a single invoice by id or URL, with its line items, totals, due and paid values. FreeAgent: GET /v2/invoices/:id.
| Name | Type | Req | Description |
|---|---|---|---|
| invoice | string | yes | The invoice's numeric id or full FreeAgent URL. |
No output schema declared.
No examples provided.
freeagent_get_profit_and_loss Get profit and loss ~110
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.
| Name | Type | Req | Description |
|---|---|---|---|
| accounting_period | string | – | An accounting year instead of dates, e.g. 2025/26. |
| from_date | string | – | Period start (YYYY-MM-DD). |
| to_date | string | – | Period end (YYYY-MM-DD). |
No output schema declared.
No examples provided.
freeagent_get_tax_timeline Get the tax timeline ~45
List upcoming tax deadlines and amounts due — VAT returns, corporation tax, self assessment and so on. FreeAgent: GET /v2/company/tax_timeline.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
freeagent_list_bank_accounts List bank accounts ~60
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.
| Name | Type | Req | Description |
|---|---|---|---|
| view | string | – | Only one kind of account. |
No output schema declared.
No examples provided.
freeagent_list_bank_transactions List bank transactions ~207
List the transactions on one bank account, e.g. view=unexplained for what still needs reconciling. FreeAgent: GET /v2/bank_transactions?bank_account=….
| Name | Type | Req | Description |
|---|---|---|---|
| bank_account | string | yes | The bank account's numeric id or full FreeAgent URL. |
| from_date | string | – | Transactions dated on or after (YYYY-MM-DD). |
| last_uploaded | boolean | – | Only transactions from the latest statement upload. |
| page | integer | – | Page number, starting at 1. |
| per_page | integer | – | Items per page, 1-100 (default 25). |
| to_date | string | – | Transactions dated on or before (YYYY-MM-DD). |
| updated_since | string | – | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
| view | string | – | Filter (default all). unexplained = not yet reconciled. |
No output schema declared.
No examples provided.
freeagent_list_bills List bills ~210
List supplier bills (purchases), optionally by date range, contact or project, filtered by status. FreeAgent: GET /v2/bills.
| Name | Type | Req | Description |
|---|---|---|---|
| contact | string | – | Only for this contact — its numeric id or full FreeAgent URL. |
| from_date | string | – | Bills dated on or after (YYYY-MM-DD). |
| nested_bill_items | boolean | – | Include each bill's line items. |
| page | integer | – | Page number, starting at 1. |
| per_page | integer | – | Items per page, 1-100 (default 25). |
| project | string | – | Only for this project — its numeric id or full FreeAgent URL. |
| to_date | string | – | Bills dated on or before (YYYY-MM-DD). |
| updated_since | string | – | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
| view | string | – | Filter by status. |
No output schema declared.
No examples provided.
freeagent_list_contacts List contacts ~136
List contacts (clients and suppliers), with their account balance. FreeAgent: GET /v2/contacts.
| Name | Type | Req | Description |
|---|---|---|---|
| page | integer | – | Page number, starting at 1. |
| per_page | integer | – | Items per page, 1-100 (default 25). |
| sort | string | – | Sort order; a leading - means descending. |
| updated_since | string | – | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
| view | string | – | Filter (default active). open_clients = clients with unpaid invoices. |
No output schema declared.
No examples provided.
freeagent_list_expenses List expenses ~174
List expense claims (out-of-pocket spending and mileage), optionally by date range or project. FreeAgent: GET /v2/expenses.
| Name | Type | Req | Description |
|---|---|---|---|
| from_date | string | – | Expenses dated on or after (YYYY-MM-DD). |
| page | integer | – | Page number, starting at 1. |
| per_page | integer | – | Items per page, 1-100 (default 25). |
| project | string | – | Only for this project — its numeric id or full FreeAgent URL. |
| to_date | string | – | Expenses dated on or before (YYYY-MM-DD). |
| updated_since | string | – | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
| view | string | – | recent or recurring expenses. |
No output schema declared.
No examples provided.
freeagent_list_invoices List invoices ~237
List sales invoices, optionally for one contact or project, filtered by status. FreeAgent: GET /v2/invoices.
| Name | Type | Req | Description |
|---|---|---|---|
| contact | string | – | Only for this contact — its numeric id or full FreeAgent URL. |
| nested_invoice_items | boolean | – | Include each invoice's line items. |
| page | integer | – | Page number, starting at 1. |
| per_page | integer | – | Items per page, 1-100 (default 25). |
| project | string | – | Only for this project — its numeric id or full FreeAgent URL. |
| sort | string | – | Sort order (default created_at); a leading - means descending. |
| updated_since | string | – | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
| view | string | – | Filter: all, recent_open_or_overdue, open, overdue, open_or_overdue, draft, paid, scheduled_to_email, thank_you_emails, reminder_emails, or last_N_months (e.g. last_3_months). |
No output schema declared.
No examples provided.
freeagent_list_projects List projects ~121
List projects, optionally for one contact. FreeAgent: GET /v2/projects.
| Name | Type | Req | Description |
|---|---|---|---|
| contact | string | – | Only for this contact — its numeric id or full FreeAgent URL. |
| nested | boolean | – | Embed the related contact instead of its URL. |
| page | integer | – | Page number, starting at 1. |
| per_page | integer | – | Items per page, 1-100 (default 25). |
| sort | string | – | Sort order; a leading - means descending. |
| view | string | – | Filter by status. |
No output schema declared.
No examples provided.
freeagent_list_tasks List tasks ~160
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.
| Name | Type | Req | Description |
|---|---|---|---|
| page | integer | – | Page number, starting at 1. |
| per_page | integer | – | Items per page, 1-100 (default 25). |
| project | string | – | Only for this project — its numeric id or full FreeAgent URL. |
| sort | string | – | Sort order (default name). |
| updated_since | string | – | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
| view | string | – | Filter by status (default all). |
No output schema declared.
No examples provided.
freeagent_list_timeslips List timeslips ~247
List logged time, optionally by date range, user, task or project; view=unbilled for time not yet invoiced. FreeAgent: GET /v2/timeslips.
| Name | Type | Req | Description |
|---|---|---|---|
| from_date | string | – | Timeslips dated on or after (YYYY-MM-DD). |
| nested | boolean | – | Embed related user, task and project instead of URLs. |
| page | integer | – | Page number, starting at 1. |
| per_page | integer | – | Items per page, 1-100 (default 25). |
| project | string | – | Only for this project — its numeric id or full FreeAgent URL. |
| task | string | – | Only for this task — its numeric id or full FreeAgent URL. |
| to_date | string | – | Timeslips dated on or before (YYYY-MM-DD). |
| updated_since | string | – | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
| user | string | – | Only for this user — its numeric id or full FreeAgent URL. |
| view | string | – | Filter (default all). |
No output schema declared.
No examples provided.
freeagent_update_contact Update a contact ~317
Update fields on an existing contact; only the fields you pass change. status=Hidden hides it (reversible with Active). FreeAgent: PUT /v2/contacts/:id.
| Name | Type | Req | Description |
|---|---|---|---|
| address1 | string | – | Address line 1. |
| address2 | string | – | Address line 2. |
| address3 | string | – | Address line 3. |
| billing_email | string | – | Email address invoices are sent to. |
| charge_sales_tax | string | – | Whether to charge VAT/sales tax. |
| contact | string | yes | The contact's numeric id or full FreeAgent URL. |
| contact_name_on_invoices | boolean | – | Show the contact's name on invoices. |
| country | string | – | Country name, e.g. United Kingdom. |
| default_payment_terms_in_days | integer | – | Default payment terms for invoices to this contact. |
| string | – | Email address. | |
| first_name | string | – | Contact first name. |
| last_name | string | – | Contact last name. |
| locale | string | – | Invoice language locale, e.g. en. |
| mobile | string | – | Mobile number. |
| organisation_name | string | – | Organisation / company name. |
| phone_number | string | – | Phone number. |
| postcode | string | – | Postcode. |
| region | string | – | Region / county. |
| sales_tax_registration_number | string | – | The contact's VAT registration number. |
| status | string | – | Hide or unhide the contact. |
| town | string | – | Town or city. |
No output schema declared.
No examples provided.
How do I install the FreeAgent MCP by usefulapi server?
FreeAgent MCP by usefulapi is a hosted endpoint at https://freeagent.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · freeagent.usefulapi.io
claude mcp add --transport http io-usefulapi-freeagent 'https://freeagent.usefulapi.io/mcp'
What is the FreeAgent MCP by usefulapi server?
FreeAgent MCP by usefulapi is listed in the public MCP registry as io.usefulapi/freeagent. Read FreeAgent contacts, invoices, bills, banking and reports; add contacts, draft invoices, time. This page covers its hosted endpoint (https://freeagent.usefulapi.io/mcp).
Is the FreeAgent MCP by usefulapi server safe to use?
FreeAgent MCP by usefulapi scores 18 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the FreeAgent MCP by usefulapi server expose?
FreeAgent MCP by usefulapi exposes 20 tools: freeagent_get_company, freeagent_get_current_user, freeagent_get_tax_timeline, freeagent_list_contacts, freeagent_get_contact, and 15 more. Their descriptions and schemas cost roughly 2,992 tokens of context every time the server is loaded.
Does the FreeAgent MCP by usefulapi server require authentication?
Its publisher declares no required credentials for FreeAgent MCP by usefulapi. We have not been able to confirm that against the live endpoint, and a server can require authorisation without declaring it here.
Is the FreeAgent MCP by usefulapi server still maintained?
FreeAgent MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 7 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the FreeAgent MCP by usefulapi server?
VerifyMCP ran 4 checks on FreeAgent MCP by usefulapi, covering TLS certificate, HSTS header, DNSSEC and Transport. 7 items could not be completed, a gap on our side rather than a finding about FreeAgent MCP by usefulapi: Authorization, HTTPS, Schema quality, Stability and 3 more. 5 categories score 0 for that reason, because we only credit what we can confirm. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.