KosmoKrator

other

Freeagent MCP Integration for LangGraph

Connect Freeagent to LangGraph 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 LangGraph

Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions.

Use a graph node that calls the KosmoKrator CLI for deterministic steps or an MCP client for dynamic tool selection. The gateway is local, scoped to this integration, and starts with --write=deny so LangGraph can inspect read-capable tools without receiving write access by default.

Freeagent MCP Config for LangGraph

Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.

{
  "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 LangGraph

LangGraph 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 LangGraphClient-level gateway setup.