# FreeAgent MCP by usefulapi (remote · freeagent.usefulapi.io)

Read FreeAgent contacts, invoices, bills, banking and reports; add contacts, draft invoices, time.

- Trust score: 18/100 (low)
- Change this week: −57
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-07

## Components

- remote · `freeagent.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-freeagent/freeagent.md), [page](https://verifymcp.io/servers/io-usefulapi-freeagent/freeagent)

## Channel facts

- Endpoint: `https://freeagent.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.29.3`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-07.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.
  - HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**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.

## Install

### 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.

### Claude

```bash
claude mcp add --transport http io-usefulapi-freeagent 'https://freeagent.usefulapi.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-freeagent": {
      "url": "https://freeagent.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-usefulapi-freeagent": {
      "type": "http",
      "url": "https://freeagent.usefulapi.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-usefulapi-freeagent]
url = "https://freeagent.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-freeagent": {
      "type": "remote",
      "url": "https://freeagent.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-freeagent --url 'https://freeagent.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-freeagent:
    url: "https://freeagent.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-freeagent": {
      "Transport": "http",
      "Url": "https://freeagent.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-freeagent -t streamable-http -u 'https://freeagent.usefulapi.io/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-freeagent": {
      "type": "http",
      "url": "https://freeagent.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-06 (score 18, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-11-02 (score 18, −58)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.80 → unverified
- [security regression] Tool safety: pass → unverified
- [security regression] Authorization: pass → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-11-01 (score 76, +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.

### 2026-10-31 (score 75, +3)

- [security improvement] Authorization: partial → pass
- [functional improvement] 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

### 2026-10-30 (score 72, 0)

- [functional] Server version: 1.22.1 → 1.22.2
- [functional] Server version: 1.22.0 → 1.22.1

### 2026-10-29 (score 72, +1)

- [functional] Server version: 1.21.0 → 1.22.0
- [functional] Server version: 1.20.0 → 1.21.0

### 2026-10-28 (score 71, 0)

- [functional] Server version: 1.18.0 → 1.20.0

### 2026-10-27 (score 71, +1)

- [functional] Server version: 1.17.0 → 1.18.0

## MCP tools (20)

### `freeagent_get_company` (~58 tokens)

Get the company

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.

### `freeagent_get_current_user` (~47 tokens)

Get the current user

Fetch the FreeAgent user the token acts as, including their URL (needed for freeagent_create_timeslip) and permission level. FreeAgent: GET /v2/users/me.

### `freeagent_get_tax_timeline` (~45 tokens)

Get the tax timeline

List upcoming tax deadlines and amounts due — VAT returns, corporation tax, self assessment and so on. FreeAgent: GET /v2/company/tax_timeline.

### `freeagent_list_contacts` (~136 tokens)

List contacts

List contacts (clients and suppliers), with their account balance. FreeAgent: GET /v2/contacts.

Input parameters:

- `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.

### `freeagent_get_contact` (~48 tokens)

Get one contact

Fetch a single contact by id or URL. FreeAgent: GET /v2/contacts/:id.

Input parameters:

- `contact` (string, required): The contact's numeric id or full FreeAgent URL.

### `freeagent_list_invoices` (~237 tokens)

List invoices

List sales invoices, optionally for one contact or project, filtered by status. FreeAgent: GET /v2/invoices.

Input parameters:

- `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).

### `freeagent_get_invoice` (~60 tokens)

Get one invoice

Fetch a single invoice by id or URL, with its line items, totals, due and paid values. FreeAgent: GET /v2/invoices/:id.

Input parameters:

- `invoice` (string, required): The invoice's numeric id or full FreeAgent URL.

### `freeagent_list_bills` (~210 tokens)

List bills

List supplier bills (purchases), optionally by date range, contact or project, filtered by status. FreeAgent: GET /v2/bills.

Input parameters:

- `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.

### `freeagent_list_expenses` (~174 tokens)

List expenses

List expense claims (out-of-pocket spending and mileage), optionally by date range or project. FreeAgent: GET /v2/expenses.

Input parameters:

- `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.

### `freeagent_list_bank_accounts` (~60 tokens)

List bank accounts

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.

Input parameters:

- `view` (string): Only one kind of account.

### `freeagent_list_bank_transactions` (~207 tokens)

List bank transactions

List the transactions on one bank account, e.g. view=unexplained for what still needs reconciling. FreeAgent: GET /v2/bank_transactions?bank_account=….

Input parameters:

- `bank_account` (string, required): 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.

### `freeagent_list_projects` (~121 tokens)

List projects

List projects, optionally for one contact. FreeAgent: GET /v2/projects.

Input parameters:

- `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.

### `freeagent_list_tasks` (~160 tokens)

List tasks

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.

Input parameters:

- `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).

### `freeagent_list_timeslips` (~247 tokens)

List timeslips

List logged time, optionally by date range, user, task or project; view=unbilled for time not yet invoiced. FreeAgent: GET /v2/timeslips.

Input parameters:

- `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).

### `freeagent_get_profit_and_loss` (~110 tokens)

Get profit and loss

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.

Input parameters:

- `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).

### `freeagent_get_balance_sheet` (~62 tokens)

Get the balance sheet

Balance sheet — capital and current assets, liabilities and owners' equity — as at a date (default today). FreeAgent: GET /v2/accounting/balance_sheet.

Input parameters:

- `as_at_date` (string): Balance sheet date (YYYY-MM-DD).

### `freeagent_create_contact` (~279 tokens)

Create a contact

Create a client or supplier contact. Give either organisation_name, or first_name and last_name. FreeAgent: POST /v2/contacts.

Input parameters:

- `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.
- `email` (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.

### `freeagent_update_contact` (~317 tokens)

Update a contact

Update fields on an existing contact; only the fields you pass change. status=Hidden hides it (reversible with Active). FreeAgent: PUT /v2/contacts/:id.

Input parameters:

- `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, required): 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.
- `email` (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.

### `freeagent_create_draft_invoice` (~259 tokens)

Create a draft invoice

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.

Input parameters:

- `comments` (string): Comments printed on the invoice.
- `contact` (string, required): 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, required): 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, required): The invoice lines.
- `payment_terms_in_days` (integer, required): 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.

### `freeagent_create_timeslip` (~155 tokens)

Log a timeslip

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.

Input parameters:

- `comment` (string): What the time was spent on.
- `dated_on` (string, required): Day the work was done (YYYY-MM-DD).
- `hours` (number, required): Hours worked, e.g. 1.5.
- `project` (string, required): The project's numeric id or full FreeAgent URL.
- `task` (string, required): The task's numeric id or full FreeAgent URL.
- `user` (string, required): The user's numeric id or full FreeAgent URL.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-freeagent/freeagent#diagnostics

## Score history

- 2026-11-07: 18
- 2026-11-06: 18
- 2026-11-05: 18
- 2026-11-04: 18
- 2026-11-03: 18
- 2026-11-02: 18
- 2026-11-01: 76
- 2026-10-31: 75
- 2026-10-30: 72
- 2026-10-29: 72
- 2026-10-28: 71
- 2026-10-27: 71
- 2026-10-26: 70
- 2026-10-25: 70
- 2026-10-24: 69
- 2026-10-23: 69
- 2026-10-22: 68
- 2026-10-21: 68
- 2026-10-20: 67
- 2026-10-19: 67
- 2026-10-18: 66
- 2026-10-17: 66
- 2026-10-16: 66
- 2026-10-15: 65
- 2026-10-14: 65
- 2026-10-13: 62
- 2026-10-12: 61
- 2026-10-11: 61
- 2026-10-10: 61
- 2026-10-08: 73

## Common questions

### 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.

## Links

- Remote endpoint: https://freeagent.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/freeagent/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-freeagent/freeagent.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-freeagent/freeagent/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/io-usefulapi-freeagent/freeagent.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-freeagent/freeagent