FreeAgent MCP by usefulapi is an MCP server published by io.usefulapi, hosted at freeagent.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 20 tools, including freeagent_get_company, freeagent_get_current_user, freeagent_get_tax_timeline, freeagent_list_contacts, freeagent_get_contact.
Read FreeAgent contacts, invoices, bills, banking and reports; add contacts, draft invoices, time.
4,263 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs 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.
No parameters.
{
"name": "freeagent_get_company",
"title": "Get the company",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the company",
"readOnlyHint": true
}
}Fetch the FreeAgent user the token acts as, including their URL (needed for freeagent_create_timeslip) and permission level. FreeAgent: GET /v2/users/me.
No parameters.
{
"name": "freeagent_get_current_user",
"title": "Get the current user",
"description": "Fetch the FreeAgent user the token acts as, including their URL (needed for freeagent_create_timeslip) and permission level. FreeAgent: GET /v2/users/me.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the current user",
"readOnlyHint": true
}
}List upcoming tax deadlines and amounts due — VAT returns, corporation tax, self assessment and so on. FreeAgent: GET /v2/company/tax_timeline.
No parameters.
{
"name": "freeagent_get_tax_timeline",
"title": "Get the tax timeline",
"description": "List upcoming tax deadlines and amounts due — VAT returns, corporation tax, self assessment and so on. FreeAgent: GET /v2/company/tax_timeline.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the tax timeline",
"readOnlyHint": true
}
}List contacts (clients and suppliers), with their account balance. FreeAgent: GET /v2/contacts.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| sort | string | Sort order; a leading - means descending. |
| view | string | Filter (default active). open_clients = clients with unpaid invoices. |
| per_page | integer | Items per page, 1-100 (default 25). |
| updated_since | string | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
{
"name": "freeagent_list_contacts",
"title": "List contacts",
"description": "List contacts (clients and suppliers), with their account balance. FreeAgent: GET /v2/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"sort": {
"enum": [
"name",
"-name",
"created_at",
"-created_at",
"updated_at",
"-updated_at"
],
"type": "string",
"description": "Sort order; a leading - means descending."
},
"view": {
"enum": [
"all",
"active",
"clients",
"suppliers",
"active_projects",
"completed_projects",
"open_clients",
"open_suppliers",
"hidden"
],
"type": "string",
"description": "Filter (default active). open_clients = clients with unpaid invoices."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 25)."
},
"updated_since": {
"type": "string",
"description": "Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true
}
}Fetch a single contact by id or URL. FreeAgent: GET /v2/contacts/:id.
| Parameter | Type | Description |
|---|---|---|
| contact * | string | The contact's numeric id or full FreeAgent URL. |
{
"name": "freeagent_get_contact",
"title": "Get one contact",
"description": "Fetch a single contact by id or URL. FreeAgent: GET /v2/contacts/:id.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact"
],
"properties": {
"contact": {
"type": "string",
"description": "The contact's numeric id or full FreeAgent URL."
}
}
},
"annotations": {
"title": "Get one contact",
"readOnlyHint": true
}
}List sales invoices, optionally for one contact or project, filtered by status. FreeAgent: GET /v2/invoices.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| sort | string | Sort order (default created_at); a leading - means descending. |
| 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). |
| contact | string | Only for this contact — its numeric id or full FreeAgent URL. |
| project | string | Only for this project — its numeric id or full FreeAgent URL. |
| per_page | integer | Items per page, 1-100 (default 25). |
| updated_since | string | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
| nested_invoice_items | boolean | Include each invoice's line items. |
{
"name": "freeagent_list_invoices",
"title": "List invoices",
"description": "List sales invoices, optionally for one contact or project, filtered by status. FreeAgent: GET /v2/invoices.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"sort": {
"enum": [
"created_at",
"-created_at",
"updated_at",
"-updated_at"
],
"type": "string",
"description": "Sort order (default created_at); a leading - means descending."
},
"view": {
"type": "string",
"pattern": "^(all|recent_open_or_overdue|open|overdue|open_or_overdue|draft|paid|scheduled_to_email|thank_you_emails|reminder_emails|last_\\d+_months)$",
"description": "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)."
},
"contact": {
"type": "string",
"description": "Only for this contact — its numeric id or full FreeAgent URL."
},
"project": {
"type": "string",
"description": "Only for this project — its numeric id or full FreeAgent URL."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 25)."
},
"updated_since": {
"type": "string",
"description": "Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z."
},
"nested_invoice_items": {
"type": "boolean",
"description": "Include each invoice's line items."
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true
}
}Fetch a single invoice by id or URL, with its line items, totals, due and paid values. FreeAgent: GET /v2/invoices/:id.
| Parameter | Type | Description |
|---|---|---|
| invoice * | string | The invoice's numeric id or full FreeAgent URL. |
{
"name": "freeagent_get_invoice",
"title": "Get one invoice",
"description": "Fetch a single invoice by id or URL, with its line items, totals, due and paid values. FreeAgent: GET /v2/invoices/:id.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice"
],
"properties": {
"invoice": {
"type": "string",
"description": "The invoice's numeric id or full FreeAgent URL."
}
}
},
"annotations": {
"title": "Get one invoice",
"readOnlyHint": true
}
}List supplier bills (purchases), optionally by date range, contact or project, filtered by status. FreeAgent: GET /v2/bills.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| view | string | Filter by status. |
| contact | string | Only for this contact — its numeric id or full FreeAgent URL. |
| project | string | Only for this project — its numeric id or full FreeAgent URL. |
| to_date | string | Bills dated on or before (YYYY-MM-DD). |
| per_page | integer | Items per page, 1-100 (default 25). |
| from_date | string | Bills dated on or after (YYYY-MM-DD). |
| updated_since | string | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
| nested_bill_items | boolean | Include each bill's line items. |
List expense claims (out-of-pocket spending and mileage), optionally by date range or project. FreeAgent: GET /v2/expenses.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| view | string | recent or recurring expenses. |
| project | string | Only for this project — its numeric id or full FreeAgent URL. |
| to_date | string | Expenses dated on or before (YYYY-MM-DD). |
| per_page | integer | Items per page, 1-100 (default 25). |
| from_date | string | Expenses dated on or after (YYYY-MM-DD). |
| updated_since | string | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
{
"name": "freeagent_list_expenses",
"title": "List expenses",
"description": "List expense claims (out-of-pocket spending and mileage), optionally by date range or project. FreeAgent: GET /v2/expenses.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"view": {
"enum": [
"recent",
"recurring"
],
"type": "string",
"description": "recent or recurring expenses."
},
"project": {
"type": "string",
"description": "Only for this project — its numeric id or full FreeAgent URL."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Expenses dated on or before (YYYY-MM-DD)."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 25)."
},
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Expenses dated on or after (YYYY-MM-DD)."
},
"updated_since": {
"type": "string",
"description": "Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z."
}
}
},
"annotations": {
"title": "List expenses",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| view | string | Only one kind of account. |
{
"name": "freeagent_list_bank_accounts",
"title": "List bank accounts",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"view": {
"enum": [
"standard_bank_accounts",
"credit_card_accounts",
"paypal_accounts"
],
"type": "string",
"description": "Only one kind of account."
}
}
},
"annotations": {
"title": "List bank accounts",
"readOnlyHint": true
}
}List the transactions on one bank account, e.g. view=unexplained for what still needs reconciling. FreeAgent: GET /v2/bank_transactions?bank_account=….
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| view | string | Filter (default all). unexplained = not yet reconciled. |
| to_date | string | Transactions dated on or before (YYYY-MM-DD). |
| per_page | integer | Items per page, 1-100 (default 25). |
| from_date | string | Transactions dated on or after (YYYY-MM-DD). |
| bank_account * | string | The bank account's numeric id or full FreeAgent URL. |
| last_uploaded | boolean | Only transactions from the latest statement upload. |
| updated_since | string | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
{
"name": "freeagent_list_bank_transactions",
"title": "List bank transactions",
"description": "List the transactions on one bank account, e.g. view=unexplained for what still needs reconciling. FreeAgent: GET /v2/bank_transactions?bank_account=….",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"bank_account"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"view": {
"enum": [
"all",
"unexplained",
"explained",
"manual",
"imported",
"marked_for_review"
],
"type": "string",
"description": "Filter (default all). unexplained = not yet reconciled."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Transactions dated on or before (YYYY-MM-DD)."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 25)."
},
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Transactions dated on or after (YYYY-MM-DD)."
},
"bank_account": {
"type": "string",
"description": "The bank account's numeric id or full FreeAgent URL."
},
"last_uploaded": {
"type": "boolean",
"description": "Only transactions from the latest statement upload."
},
"updated_since": {
"type": "string",
"description": "Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z."
}
}
},
"annotations": {
"title": "List bank transactions",
"readOnlyHint": true
}
}List projects, optionally for one contact. FreeAgent: GET /v2/projects.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| sort | string | Sort order; a leading - means descending. |
| view | string | Filter by status. |
| nested | boolean | Embed the related contact instead of its URL. |
| contact | string | Only for this contact — its numeric id or full FreeAgent URL. |
| per_page | integer | Items per page, 1-100 (default 25). |
{
"name": "freeagent_list_projects",
"title": "List projects",
"description": "List projects, optionally for one contact. FreeAgent: GET /v2/projects.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"sort": {
"enum": [
"name",
"-name",
"contact_name",
"-contact_name",
"contact_display_name",
"-contact_display_name",
"created_at",
"-created_at",
"updated_at",
"-updated_at"
],
"type": "string",
"description": "Sort order; a leading - means descending."
},
"view": {
"enum": [
"active",
"completed",
"cancelled",
"hidden"
],
"type": "string",
"description": "Filter by status."
},
"nested": {
"type": "boolean",
"description": "Embed the related contact instead of its URL."
},
"contact": {
"type": "string",
"description": "Only for this contact — its numeric id or full FreeAgent URL."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 25)."
}
}
},
"annotations": {
"title": "List projects",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| sort | string | Sort order (default name). |
| view | string | Filter by status (default all). |
| project | string | Only for this project — its numeric id or full FreeAgent URL. |
| per_page | integer | Items per page, 1-100 (default 25). |
| updated_since | string | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
{
"name": "freeagent_list_tasks",
"title": "List tasks",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"sort": {
"enum": [
"name",
"project",
"billing_rate",
"created_at",
"updated_at"
],
"type": "string",
"description": "Sort order (default name)."
},
"view": {
"enum": [
"all",
"active",
"completed",
"hidden"
],
"type": "string",
"description": "Filter by status (default all)."
},
"project": {
"type": "string",
"description": "Only for this project — its numeric id or full FreeAgent URL."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 25)."
},
"updated_since": {
"type": "string",
"description": "Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z."
}
}
},
"annotations": {
"title": "List tasks",
"readOnlyHint": true
}
}List logged time, optionally by date range, user, task or project; view=unbilled for time not yet invoiced. FreeAgent: GET /v2/timeslips.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| task | string | Only for this task — its numeric id or full FreeAgent URL. |
| user | string | Only for this user — its numeric id or full FreeAgent URL. |
| view | string | Filter (default all). |
| nested | boolean | Embed related user, task and project instead of URLs. |
| project | string | Only for this project — its numeric id or full FreeAgent URL. |
| to_date | string | Timeslips dated on or before (YYYY-MM-DD). |
| per_page | integer | Items per page, 1-100 (default 25). |
| from_date | string | Timeslips dated on or after (YYYY-MM-DD). |
| updated_since | string | Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z. |
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.
| Parameter | Type | Description |
|---|---|---|
| to_date | string | Period end (YYYY-MM-DD). |
| from_date | string | Period start (YYYY-MM-DD). |
| accounting_period | string | An accounting year instead of dates, e.g. 2025/26. |
{
"name": "freeagent_get_profit_and_loss",
"title": "Get profit and loss",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Period end (YYYY-MM-DD)."
},
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Period start (YYYY-MM-DD)."
},
"accounting_period": {
"type": "string",
"pattern": "^\\d{4}\\/\\d{2}$",
"description": "An accounting year instead of dates, e.g. 2025/26."
}
}
},
"annotations": {
"title": "Get profit and loss",
"readOnlyHint": true
}
}Balance sheet — capital and current assets, liabilities and owners' equity — as at a date (default today). FreeAgent: GET /v2/accounting/balance_sheet.
| Parameter | Type | Description |
|---|---|---|
| as_at_date | string | Balance sheet date (YYYY-MM-DD). |
{
"name": "freeagent_get_balance_sheet",
"title": "Get the balance sheet",
"description": "Balance sheet — capital and current assets, liabilities and owners' equity — as at a date (default today). FreeAgent: GET /v2/accounting/balance_sheet.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"as_at_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Balance sheet date (YYYY-MM-DD)."
}
}
},
"annotations": {
"title": "Get the balance sheet",
"readOnlyHint": true
}
}Create a client or supplier contact. Give either organisation_name, or first_name and last_name. FreeAgent: POST /v2/contacts.
| Parameter | Type | Description |
|---|---|---|
| town | string | Town or city. |
| string | Email address. | |
| locale | string | Invoice language locale, e.g. en. |
| mobile | string | Mobile number. |
| region | string | Region / county. |
| country | string | Country name, e.g. United Kingdom. |
| address1 | string | Address line 1. |
| address2 | string | Address line 2. |
| address3 | string | Address line 3. |
| postcode | string | Postcode. |
| last_name | string | Contact last name. |
| first_name | string | Contact first name. |
Update fields on an existing contact; only the fields you pass change. status=Hidden hides it (reversible with Active). FreeAgent: PUT /v2/contacts/:id.
| Parameter | Type | Description |
|---|---|---|
| town | string | Town or city. |
| string | Email address. | |
| locale | string | Invoice language locale, e.g. en. |
| mobile | string | Mobile number. |
| region | string | Region / county. |
| status | string | Hide or unhide the contact. |
| contact * | string | The contact's numeric id or full FreeAgent URL. |
| country | string | Country name, e.g. United Kingdom. |
| address1 | string | Address line 1. |
| address2 | string | Address line 2. |
| address3 | string | Address line 3. |
| postcode |
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.
| Parameter | Type | Description |
|---|---|---|
| due_on | string | Explicit due date, if not derived from payment terms (YYYY-MM-DD). |
| contact * | string | The contact being invoiced's numeric id or full FreeAgent URL. |
| project | string | The project's numeric id or full FreeAgent URL. |
| comments | string | Comments printed on the invoice. |
| currency | string | ISO currency code, e.g. GBP (defaults to the company currency). |
| dated_on * | string | Invoice date (YYYY-MM-DD). |
| reference | string | Invoice reference/number; omit to use the next in sequence. |
| po_reference | string | The customer's purchase-order reference. |
| exchange_rate | number | Exchange rate for a foreign-currency invoice. |
| invoice_items |
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.
| Parameter | Type | Description |
|---|---|---|
| task * | string | The task's numeric id or full FreeAgent URL. |
| user * | string | The user's numeric id or full FreeAgent URL. |
| hours * | number | Hours worked, e.g. 1.5. |
| comment | string | What the time was spent on. |
| project * | string | The project's numeric id or full FreeAgent URL. |
| dated_on * | string | Day the work was done (YYYY-MM-DD). |
{
"name": "freeagent_create_timeslip",
"title": "Log a timeslip",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"user",
"project",
"task",
"dated_on",
"hours"
],
"properties": {
"task": {
"type": "string",
"description": "The task's numeric id or full FreeAgent URL."
},
"user": {
"type": "string",
"description": "The user's numeric id or full FreeAgent URL."
},
"hours": {
"type": "number",
"maximum": 24,
"description": "Hours worked, e.g. 1.5.",
"exclusiveMinimum": 0
},
"comment": {
"type": "string",
"description": "What the time was spent on."
},
"project": {
"type": "string",
"description": "The project's numeric id or full FreeAgent URL."
},
"dated_on": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Day the work was done (YYYY-MM-DD)."
}
}
},
"annotations": {
"title": "Log a timeslip",
"destructiveHint": true
}
}Tools for FreeAgent, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which sales invoices are overdue and who owes me?"; "What are my upcoming tax deadlines and the amounts due?"; "Show my profit and loss for this financial year so far.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes FreeAgent data. Free plan: 50 tool calls per month. Run freeagent_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run freeagent_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run freeagent_upgrade without a plan: it returns both plans, each with a payment link for the user to open. freeagent_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "freeagent_list_bills",
"title": "List bills",
"description": "List supplier bills (purchases), optionally by date range, contact or project, filtered by status. FreeAgent: GET /v2/bills.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"view": {
"enum": [
"all",
"open",
"overdue",
"open_or_overdue",
"open_or_overdue_payments",
"open_or_overdue_refunds",
"paid",
"recurring",
"hire_purchase",
"cis"
],
"type": "string",
"description": "Filter by status."
},
"contact": {
"type": "string",
"description": "Only for this contact — its numeric id or full FreeAgent URL."
},
"project": {
"type": "string",
"description": "Only for this project — its numeric id or full FreeAgent URL."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Bills dated on or before (YYYY-MM-DD)."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 25)."
},
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Bills dated on or after (YYYY-MM-DD)."
},
"updated_since": {
"type": "string",
"description": "Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z."
},
"nested_bill_items": {
"type": "boolean",
"description": "Include each bill's line items."
}
}
},
"annotations": {
"title": "List bills",
"readOnlyHint": true
}
}{
"name": "freeagent_list_timeslips",
"title": "List timeslips",
"description": "List logged time, optionally by date range, user, task or project; view=unbilled for time not yet invoiced. FreeAgent: GET /v2/timeslips.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"task": {
"type": "string",
"description": "Only for this task — its numeric id or full FreeAgent URL."
},
"user": {
"type": "string",
"description": "Only for this user — its numeric id or full FreeAgent URL."
},
"view": {
"enum": [
"all",
"unbilled",
"running"
],
"type": "string",
"description": "Filter (default all)."
},
"nested": {
"type": "boolean",
"description": "Embed related user, task and project instead of URLs."
},
"project": {
"type": "string",
"description": "Only for this project — its numeric id or full FreeAgent URL."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Timeslips dated on or before (YYYY-MM-DD)."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 25)."
},
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Timeslips dated on or after (YYYY-MM-DD)."
},
"updated_since": {
"type": "string",
"description": "Only records updated since this ISO 8601 timestamp, e.g. 2026-01-01T00:00:00Z."
}
}
},
"annotations": {
"title": "List timeslips",
"readOnlyHint": true
}
}| phone_number | string | Phone number. |
| billing_email | string | Email address invoices are sent to. |
| charge_sales_tax | string | Whether to charge VAT/sales tax. |
| organisation_name | string | Organisation / company name. |
| contact_name_on_invoices | boolean | Show the contact's name on invoices. |
| default_payment_terms_in_days | integer | Default payment terms for invoices to this contact. |
| sales_tax_registration_number | string | The contact's VAT registration number. |
{
"name": "freeagent_create_contact",
"title": "Create a contact",
"description": "Create a client or supplier contact. Give either organisation_name, or first_name and last_name. FreeAgent: POST /v2/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"town": {
"type": "string",
"description": "Town or city."
},
"email": {
"type": "string",
"description": "Email address."
},
"locale": {
"type": "string",
"description": "Invoice language locale, e.g. en."
},
"mobile": {
"type": "string",
"description": "Mobile number."
},
"region": {
"type": "string",
"description": "Region / county."
},
"country": {
"type": "string",
"description": "Country name, e.g. United Kingdom."
},
"address1": {
"type": "string",
"description": "Address line 1."
},
"address2": {
"type": "string",
"description": "Address line 2."
},
"address3": {
"type": "string",
"description": "Address line 3."
},
"postcode": {
"type": "string",
"description": "Postcode."
},
"last_name": {
"type": "string",
"description": "Contact last name."
},
"first_name": {
"type": "string",
"description": "Contact first name."
},
"phone_number": {
"type": "string",
"description": "Phone number."
},
"billing_email": {
"type": "string",
"description": "Email address invoices are sent to."
},
"charge_sales_tax": {
"enum": [
"Auto",
"Always",
"Never"
],
"type": "string",
"description": "Whether to charge VAT/sales tax."
},
"organisation_name": {
"type": "string",
"description": "Organisation / company name."
},
"contact_name_on_invoices": {
"type": "boolean",
"description": "Show the contact's name on invoices."
},
"default_payment_terms_in_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Default payment terms for invoices to this contact."
},
"sales_tax_registration_number": {
"type": "string",
"description": "The contact's VAT registration number."
}
}
},
"annotations": {
"title": "Create a contact",
"destructiveHint": true
}
}| string |
| Postcode. |
| last_name | string | Contact last name. |
| first_name | string | Contact first name. |
| phone_number | string | Phone number. |
| billing_email | string | Email address invoices are sent to. |
| charge_sales_tax | string | Whether to charge VAT/sales tax. |
| organisation_name | string | Organisation / company name. |
| contact_name_on_invoices | boolean | Show the contact's name on invoices. |
| default_payment_terms_in_days | integer | Default payment terms for invoices to this contact. |
| sales_tax_registration_number | string | The contact's VAT registration number. |
{
"name": "freeagent_update_contact",
"title": "Update a contact",
"description": "Update fields on an existing contact; only the fields you pass change. status=Hidden hides it (reversible with Active). FreeAgent: PUT /v2/contacts/:id.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact"
],
"properties": {
"town": {
"type": "string",
"description": "Town or city."
},
"email": {
"type": "string",
"description": "Email address."
},
"locale": {
"type": "string",
"description": "Invoice language locale, e.g. en."
},
"mobile": {
"type": "string",
"description": "Mobile number."
},
"region": {
"type": "string",
"description": "Region / county."
},
"status": {
"enum": [
"Active",
"Hidden"
],
"type": "string",
"description": "Hide or unhide the contact."
},
"contact": {
"type": "string",
"description": "The contact's numeric id or full FreeAgent URL."
},
"country": {
"type": "string",
"description": "Country name, e.g. United Kingdom."
},
"address1": {
"type": "string",
"description": "Address line 1."
},
"address2": {
"type": "string",
"description": "Address line 2."
},
"address3": {
"type": "string",
"description": "Address line 3."
},
"postcode": {
"type": "string",
"description": "Postcode."
},
"last_name": {
"type": "string",
"description": "Contact last name."
},
"first_name": {
"type": "string",
"description": "Contact first name."
},
"phone_number": {
"type": "string",
"description": "Phone number."
},
"billing_email": {
"type": "string",
"description": "Email address invoices are sent to."
},
"charge_sales_tax": {
"enum": [
"Auto",
"Always",
"Never"
],
"type": "string",
"description": "Whether to charge VAT/sales tax."
},
"organisation_name": {
"type": "string",
"description": "Organisation / company name."
},
"contact_name_on_invoices": {
"type": "boolean",
"description": "Show the contact's name on invoices."
},
"default_payment_terms_in_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Default payment terms for invoices to this contact."
},
"sales_tax_registration_number": {
"type": "string",
"description": "The contact's VAT registration number."
}
}
},
"annotations": {
"title": "Update a contact",
"destructiveHint": true
}
}| array |
| The invoice lines. |
| discount_percent | number | Whole-invoice discount percentage. |
| payment_terms_in_days * | integer | Payment terms in days; 0 = due on receipt. |
{
"name": "freeagent_create_draft_invoice",
"title": "Create a draft invoice",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact",
"dated_on",
"payment_terms_in_days",
"invoice_items"
],
"properties": {
"due_on": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Explicit due date, if not derived from payment terms (YYYY-MM-DD)."
},
"contact": {
"type": "string",
"description": "The contact being invoiced's numeric id or full FreeAgent URL."
},
"project": {
"type": "string",
"description": "The project's numeric id or full FreeAgent URL."
},
"comments": {
"type": "string",
"description": "Comments printed on the invoice."
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3,
"description": "ISO currency code, e.g. GBP (defaults to the company currency)."
},
"dated_on": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Invoice date (YYYY-MM-DD)."
},
"reference": {
"type": "string",
"description": "Invoice reference/number; omit to use the next in sequence."
},
"po_reference": {
"type": "string",
"description": "The customer's purchase-order reference."
},
"exchange_rate": {
"type": "number",
"description": "Exchange rate for a foreign-currency invoice.",
"exclusiveMinimum": 0
},
"invoice_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description"
],
"properties": {
"price": {
"type": "number",
"description": "Unit price, in the invoice currency (required for non time-based items)."
},
"quantity": {
"type": "number",
"description": "Quantity (default 0)."
},
"item_type": {
"enum": [
"Hours",
"Days",
"Weeks",
"Months",
"Years",
"Products",
"Services",
"Training",
"Expenses",
"Comment",
"Bills",
"Discount",
"Credit",
"VAT",
"Stock"
],
"type": "string",
"description": "Unit type of the line (e.g. Hours, Days, Services, Products)."
},
"description": {
"type": "string",
"description": "Line description."
},
"sales_tax_rate": {
"type": "number",
"minimum": 0,
"description": "VAT rate percentage for this line, e.g. 20."
}
}
},
"minItems": 1,
"description": "The invoice lines."
},
"discount_percent": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Whole-invoice discount percentage."
},
"payment_terms_in_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Payment terms in days; 0 = due on receipt."
}
}
},
"annotations": {
"title": "Create a draft invoice",
"destructiveHint": true
}
}