INDIVIDUAL MCP TOOL

freeagent_list_contacts

List contacts (clients and suppliers), with their account balance.

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://freeagent.usefulapi.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for freeagent_list_contacts and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.freeagent-mcp]
url = "https://freeagent.usefulapi.io/mcp"
enabled = true

Claude Code

.mcp.json

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

Claude Desktop

Settings → Connectors → Add custom connector

Name: freeagent-mcp
Remote MCP URL: https://freeagent.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

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

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

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

Generic MCP

Client-specific MCP configuration

{
  "name": "freeagent-mcp",
  "transport": "streamable-http",
  "url": "https://freeagent.usefulapi.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

freeagent_get_company — Fetch the FreeAgent company these credentials belong to — name, type (e.
freeagent_get_current_user — Fetch the FreeAgent user the token acts as, including their URL (needed for freeagent_create_timeslip) and permission level.
freeagent_get_tax_timeline — List upcoming tax deadlines and amounts due — VAT returns, corporation tax, self assessment and so on.
freeagent_get_contact — Fetch a single contact by id or URL.
freeagent_list_invoices — List sales invoices, optionally for one contact or project, filtered by status.
freeagent_get_invoice — Fetch a single invoice by id or URL, with its line items, totals, due and paid values.
freeagent_list_bills — List supplier bills (purchases), optionally by date range, contact or project, filtered by status.
freeagent_list_expenses — List expense claims (out-of-pocket spending and mileage), optionally by date range or project.