Skip to content

mcp-freeagent 0.1.2-dev.9

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 01 Nov 21:04
5a9792f

v0.1.2-dev.9 (2026-11-01)

Bug Fixes

  • Leave signed attachment links out of tool results (9087909)

Documentation

  • Add the mdBook documentation site with a CI build and link check (b535841)

Install

Docker

docker run -d --name mcp-freeagent -p 8443:8443 \
  -e PUBLIC_URL=https://freeagent-mcp.example.com \
  -e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
  -e FREEAGENT_CLIENT_ID=your-oauth-identifier \
  -e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
  -e FREEAGENT_TOKEN_STORE=/data/tokens.json \
  -v mcp-freeagent-data:/data \
  -v /path/to/certs:/certs:ro \
  -e TLS_CERT_PATH=/certs/fullchain.pem \
  -e TLS_KEY_PATH=/certs/privkey.pem \
  ghcr.io/trozz/mcp-freeagent:0.1.2-dev.9

Binary

Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.

Connect

The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.

Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.

  • claude.ai: add a custom connector for https://<your PUBLIC_URL host>/freeagent and approve access at FreeAgent.
  • Claude Code: claude mcp add --transport http freeagent https://<host>/freeagent, then /mcp to sign in.

Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration