UNOFFICIAL · OPEN SOURCE · MIT · v0.1.0

Fiken.
Tools for your agent.

A typed client, MCP server and CLI for Fiken. Companies, accounts, contacts, purchases and purchase attachments.

Local setup

On a laptop, prefer stdio. Cursor can load vendor credentials from a gitignored envFile. Do not put secrets in mcp.json.

npx -y @bruchris/fiken-mcp

Local Streamable HTTP for transport tests: npm run http:fiken on 127.0.0.1:3001. Path B&B breaks npm .bin; use node …/tsx or dist.

Use your own Fiken credential in the client or host environment. The model chooses accounting fields after reading the receipt and similar bookings.

Hosted setup

This origin serves three routes:

Private-beta access to /mcp uses a host token named MCP_AUTH_TOKEN. That token authenticates the MCP client to this host. It is not a Fiken credential. Put the token in the OS or shell environment and send it as an Authorization header. Remote Cursor HTTP does not support envFile.

This host then calls Fiken with a separate vendor credential. Do not mix those layers. Cursor Authenticate / ChatGPT Sign in (MCP OAuth against this host) is not enabled on this release.

claude mcp add --transport http fiken https://fiken.bruchris.me/mcp --header "Authorization: <MCP_AUTH_TOKEN>"

Freddy imports the TypeScript client. It does not call this URL as RPC. MCP writes preview until confirmed; that confirm flag is not Freddy ApprovalService. Attach a receipt to the purchase; do not duplicate it into Fiken Innboks.

Privacy and security

This page never publishes keys. Hosted HTTP disables local filesystem attachment tools. Browser Origin values must match an exact allowlist; there is no wildcard. See SECURITY.md and the hosted setup notes.