KosmoKrator

other

Freeagent MCP Integration for Claude Agent SDK

Connect Freeagent to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

9 functions 7 read 2 write Manual OAuth token auth
Submit Freeagent feedback View package source

Connect Freeagent to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Freeagent MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "mcpServers": {
    "kosmokrator-freeagent": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=freeagent",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=freeagent --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Freeagent instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Freeagent Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the Freeagent integration catalog.

MCP toolSource functionTypeDescription
integration__freeagent__freeagent_list_invoices freeagent.freeagent_list_invoices Read List invoices from FreeAgent. Returns a paginated list of invoices with their details. Supports filtering by status (Draft, Sent, Cancelled, Late Paid, Paid), date range, contact, and project.
integration__freeagent__freeagent_get_invoice freeagent.freeagent_get_invoice Read Get the full details of a specific invoice from FreeAgent, including line items, totals, contact information, and status.
integration__freeagent__freeagent_create_invoice freeagent.freeagent_create_invoice Write Create a new invoice in FreeAgent. Requires a contact and at least one line item. Supports setting due date, currency, invoice items with quantities and prices, and comments.
integration__freeagent__freeagent_list_contacts freeagent.freeagent_list_contacts Read List contacts from FreeAgent. Returns a paginated list of contacts including customers, suppliers, and employees. Supports filtering and sorting.
integration__freeagent__freeagent_get_contact freeagent.freeagent_get_contact Read Get the full details of a specific contact from FreeAgent, including name, email, company, billing address, and contact type.
integration__freeagent__freeagent_create_contact freeagent.freeagent_create_contact Write Create a new contact in FreeAgent. Contacts can be customers, suppliers, or employees. Provide at least a name (first_name/last_name for individuals or organisation_name for companies).
integration__freeagent__freeagent_list_projects freeagent.freeagent_list_projects Read List projects from FreeAgent. Returns project names, status, budget, associated contacts, and time tracking information.
integration__freeagent__freeagent_list_expenses freeagent.freeagent_list_expenses Read List expenses from FreeAgent. Returns expense claims with amounts, categories, dates, and associated projects or contacts.
integration__freeagent__freeagent_get_current_user freeagent.freeagent_get_current_user Read Get the currently authenticated FreeAgent user profile. Returns user details like name, email, role, and company information. Useful for verifying the connection and understanding which account is active.

Related Freeagent Pages

Freeagent CLIUse direct JSON commands instead of MCP discovery. Freeagent MCPFull gateway reference and MCP tool names. KosmoKrator for Claude Agent SDKClient-level gateway setup.