FISCAi Octopus API Connector
Read-only MCP server giving AI clients access to Octopus accounting data for Belgian
FISCAi Octopus API Connector is an open-source MCP server for accounting and tax. It runs locally on your machine and is started by your AI client.
- Pricing
- Open source
- Platforms
- CLI, Self-hosted, API
- Runs
- Locally
- Version
- 1.0.0
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add fiscai-octopus-api-connector --env OCTOPUS_SOFTWARE_HOUSE_UUID='<OCTOPUS_SOFTWARE_HOUSE_UUID>' --env OCTOPUS_USER='<OCTOPUS_USER>' --env OCTOPUS_PASSWORD='<OCTOPUS_PASSWORD>' --env OCTOPUS_CACHE_KEY='<OCTOPUS_CACHE_KEY>' -- npx -y https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"fiscai-octopus-api-connector": {
"command": "npx",
"args": [
"-y",
"https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb"
],
"env": {
"OCTOPUS_SOFTWARE_HOUSE_UUID": "<OCTOPUS_SOFTWARE_HOUSE_UUID>",
"OCTOPUS_USER": "<OCTOPUS_USER>",
"OCTOPUS_PASSWORD": "<OCTOPUS_PASSWORD>",
"OCTOPUS_CACHE_KEY": "<OCTOPUS_CACHE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"fiscai-octopus-api-connector": {
"command": "npx",
"args": [
"-y",
"https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb"
],
"env": {
"OCTOPUS_SOFTWARE_HOUSE_UUID": "<OCTOPUS_SOFTWARE_HOUSE_UUID>",
"OCTOPUS_USER": "<OCTOPUS_USER>",
"OCTOPUS_PASSWORD": "<OCTOPUS_PASSWORD>",
"OCTOPUS_CACHE_KEY": "<OCTOPUS_CACHE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"fiscai-octopus-api-connector": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb"
],
"env": {
"OCTOPUS_SOFTWARE_HOUSE_UUID": "<OCTOPUS_SOFTWARE_HOUSE_UUID>",
"OCTOPUS_USER": "<OCTOPUS_USER>",
"OCTOPUS_PASSWORD": "<OCTOPUS_PASSWORD>",
"OCTOPUS_CACHE_KEY": "<OCTOPUS_CACHE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"fiscai-octopus-api-connector": {
"command": "npx",
"args": [
"-y",
"https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb"
],
"env": {
"OCTOPUS_SOFTWARE_HOUSE_UUID": "<OCTOPUS_SOFTWARE_HOUSE_UUID>",
"OCTOPUS_USER": "<OCTOPUS_USER>",
"OCTOPUS_PASSWORD": "<OCTOPUS_PASSWORD>",
"OCTOPUS_CACHE_KEY": "<OCTOPUS_CACHE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"fiscai-octopus-api-connector": {
"command": "npx",
"args": [
"-y",
"https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb"
],
"env": {
"OCTOPUS_SOFTWARE_HOUSE_UUID": "<OCTOPUS_SOFTWARE_HOUSE_UUID>",
"OCTOPUS_USER": "<OCTOPUS_USER>",
"OCTOPUS_PASSWORD": "<OCTOPUS_PASSWORD>",
"OCTOPUS_CACHE_KEY": "<OCTOPUS_CACHE_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
OCTOPUS_SOFTWARE_HOUSE_UUIDUUID die Octopus aan uw software toekent (header softwareHouseUuid). Geheim.RequiredOCTOPUS_USERGebruikersnaam (e-mail) van de Octopus-gebruiker met API-toegang. Geheim.RequiredOCTOPUS_PASSWORDWachtwoord van die gebruiker. Alleen in het geheugen; nooit gelogd. Geheim.RequiredOCTOPUS_CACHE_KEYOptioneel, minstens 16 tekens: versleutelt de lokale cache en synchronisatie op schijf. Zonder sleutel alleen in het geheugen. Geheim.OCTOPUS_LOCALE_IDlocaleId voor het dossiertoken (0-4, standaard 1; verifieer actuele regel).OCTOPUS_ALLOWED_DOSSIERSOptioneel: komma-gescheiden dossier-id's; andere dossiers worden geweigerd.OCTOPUS_QUOTA_RESERVEAantal calls per endpoint dat de connector vrijhoudt (standaard 0).OCTOPUS_AMOUNTS_MODEmovement (beweging per periode, standaard) of cumulative. Verifieer actuele regel met de controle in de dossieroverdracht.OCTOPUS_WRITE_ENABLEDStandaard uit. Alleen true zet de tweestaps-schrijftools aan.OCTOPUS_WRITE_MAX_PER_DAY1 tot 200, standaard 20.
About FISCAi Octopus API Connector
Connects AI assistants such as Grok Bot, Claude, Cursor and Copilot to the Octopus accounting REST API, letting them read fiscal years, journals, chart of accounts, balances, booking lines, relations and open items. Because Octopus limits daily calls per endpoint, the connector caches responses and syncs only changed records through the modified-since endpoints, and it counts calls before sending them.
On top of the raw API it builds a trial balance, ageing of open items, MAR key figures and a year-end dossier transfer package with checksums for the next accountant. Exports are available as CSV, JSON, Excel and Parquet. It runs locally over stdio, with credentials kept in memory and optional encryption of the local cache.
It is aimed at Belgian bookkeepers and accountants working with the MAR chart of accounts and Belgian VAT. It is Apache 2.0 licensed and is not endorsed by Octopus.
What it does
- Read-only Octopus access
- Exposes dossiers, journals, balances, booking lines and reports to MCP clients without write access by default.
- Daily limit management
- Counts each API call against Octopus daily quotas and refuses calls once the limit is reached.
- Local caching and sync
- Stores responses locally and updates them through modified-since endpoints, optionally encrypted on disk.
- Trial balance and analyses
- Builds a trial balance, ageing of open items and MAR key figures, which the API does not provide directly.
- Dossier transfer package
- Produces a per-fiscal-year transfer bundle with control checks and SHA-256 manifest, resumable after limits.
- Multi-format exports
- Exports data to CSV, JSON, Excel and Parquet for spreadsheets, databases and notebooks.
Good for
- Reviewing a client's trial balance for a fiscal year through an AI assistant
- Tracking ageing of customer and supplier open items
- Preparing meeting notes and draft reminder e-mails for recurring VAT and annual accounts obligations
- Handing over a client dossier to a new accountant with a verified transfer package
- Exporting Octopus bookings to Excel or Power BI for analysis
Pricing
Open source
Free open-source connector, Apache 2.0; no paid plan.
FISCAi Octopus API Connector FAQ
Can the connector change data in Octopus?
Write tools are off by default and only appear when OCTOPUS_WRITE_ENABLED is set to true. Even then, writes are proposals that need a confirmation code and a daily maximum. Delete operations are not offered.
Which software does FISCAi Octopus API Connector run in?
It runs as a local stdio MCP server and works with Grok Bot, Claude, Cursor, Windsurf and VS Code Copilot, plus a command-line interface.
Is there a hosted plan or a cost?
The project is open source under Apache 2.0 and runs on your own computer. It does not use the paid Octopus Management API.
Which accounting rules does FISCAi Octopus API Connector follow?
It is built for the Belgian chart of accounts (MAR) and Belgian VAT rules. Use outside Belgium requires checking local rules yourself.
Has FISCAi Octopus API Connector been tested with a live Octopus dossier?
Not yet. It has been tested against a mocked API built from the official specification, as Octopus has no sandbox.
How do I add FISCAi Octopus API Connector to Claude Code?
Run this command in your terminal: claude mcp add fiscai-octopus-api-connector --env OCTOPUS_SOFTWARE_HOUSE_UUID='<OCTOPUS_SOFTWARE_HOUSE_UUID>' --env OCTOPUS_USER='<OCTOPUS_USER>' --env OCTOPUS_PASSWORD='<OCTOPUS_PASSWORD>' --env OCTOPUS_CACHE_KEY='<OCTOPUS_CACHE_KEY>' -- npx -y https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb
What are the best alternatives to FISCAi Octopus API Connector?
The closest alternatives to FISCAi Octopus API Connector are FISCAi Yuki API Connector, Nationale Boekhoudmaatschappij, Praat met je Boekhouding (Chat with your Books), Cijferlink and PolyAccounts accounting.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.