wavingcatapps/freeagent-mcp-vercel

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

10 stars 4 forks 品質 76 トレンド 38MIT

A Model Context Protocol (MCP) server for the FreeAgent accounting API. Enables LLMs to manage contacts, invoices, estimates, bills, expenses, timeslips, projects, tasks, bank accounts, and more.

概要

A Model Context Protocol (MCP) server for the FreeAgent accounting API. Enables LLMs to manage contacts, invoices, estimates, bills, expenses, timeslips, projects, tasks, bank accounts, and more. By my own admission, most of this project is vibe coded. - : contacts, invoices (incl. transitions, email, duplicate, direct debit), estimates, bills, recurring invoices, price list items, expenses, timeslips, projects, tasks, bank accounts/feeds/statements (JSON lines), credit notes + reconciliations, notes, attachments (metadata), journals, capital assets, accounting reports (P&L, balance sheet, trial balance, cashflow, ledger), VAT/corp tax/income tax/final accounts, payroll, properties/stock/hire purchases, CIS, sales tax periods, account locks, categories, company info, and users - : reconcile_bank_transaction, log_expense, and invoice_from_timeslips collapse multi-call sequences into single tool calls and resolve human-friendly hints (names, codes, references) to FreeAgent URLs...

README

以下は原文 README の抜粋です。原文を見る。

FreeAgent MCP Server

A Model Context Protocol (MCP) server for the FreeAgent accounting API. Enables LLMs to manage contacts, invoices, estimates, bills, expenses, timeslips, projects, tasks, bank accounts, and more.

By my own admission, most of this project is vibe coded.

Features

Broad FreeAgent coverage: contacts, invoices (incl. transitions, email, duplicate, direct debit), estimates, bills, recurring invoices, price list items, expenses, timeslips, projects, tasks, bank accounts/feeds/statements (JSON lines), credit notes + reconciliations, notes, attachments (metadata), journals, capital assets, accounting reports (P&L, balance sheet, trial balance, cashflow, ledger), VAT/corp tax/income tax/final accounts, payroll, properties/stock/hire purchases, CIS, sales tax periods, account locks, categories, company info, and users
Intent-bundle tools: reconcile_bank_transaction, log_expense, and invoice_from_timeslips collapse multi-call sequences into single tool calls and resolve human-friendly hints (names, codes, references) to FreeAgent URLs server-side
Tool-search mode (FREEAGENT_TOOL_SEARCH=true): optional — collapses the catalog behind freeagent_search_tools / freeagent_call_tool for a smaller tools/list. Default is the full catalog (including on Vercel)
MCP elicitation: create_invoice falls back to a form elicitation when contact is omitted (on clients that support it)
Two deployment modes: local (stdio) or cloud (Vercel serverless via Streamable HTTP)
OAuth 2.0: stateless JWT-based auth for serverless, or direct token for local use
Tool annotations: readOnlyHint, destructiveHint, idempotentHint, openWorldHint on every tool
Zod validation: strict input schemas with .describe() on all fields
Dual response formats: Markdown (human-readable) or JSON (structured)
Pagination: proper header parsing with x-total-count and Link headers
Rate limit handling: clear error messages with retry-after guidance
Sandbox support: test safely against FreeAgent’s sandbox environment

Deployment Options

Local (stdio) - for Claude Desktop

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
     "mcpServers": {
       "freeagent": {
         "command": "node",
         "args": ["/path/to/freeagent-mcp-server/dist/index.js"],
         "env": {
           "FREEAGENT_ACCESS_TOKEN": "your_token",
           "FREEAGENT_USE_SANDBOX": "true"
         }
       }
     }
   }