Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

FISCAi Octopus API Connector

de MnrAlciversión 1.0.0i★ 0iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.MnrAlci/fiscai-octopus-api-connector

Cómo instalar

Qué hace

Read-only Octopus API for Belgian accountants. Powered by FISCALCI Accounting & Tax (Askin Alci)

Texto original del autor

  • Conexión Se ejecuta en tu computadora
  • Cuenta o clave Necesita OCTOPUS_SOFTWARE_HOUSE_UUID, OCTOPUS_USER, OCTOPUS_PASSWORD, OCTOPUS_CACHE_KEY
  • Categoría Contabilidad, finanzas e impuestos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso12/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Descarga el instalador del autor

    Descargar el archivo .mcpb del creador

    El archivo .mcpb viene directo del autor; no lo modificamos

  2. Haz doble clic en el archivo y pulsa Install en la app de Claude de escritorio

  3. Pruébalo

    Usa FISCAi Octopus API Connector y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando FISCAi Octopus API Connector o muestra una herramienta de FISCAi Octopus API Connector en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar FISCAi Octopus API Connector

FISCAi Octopus API Connector se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar FISCAi Octopus API Connector

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

B · Otros en Contabilidad, finanzas e impuestos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Claude Code todavía no puede conectar FISCAi Octopus API Connector

El autor solo ofrece un instalador para la app de Claude de escritorio

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar FISCAi Octopus API Connector

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Cursor todavía no puede conectar FISCAi Octopus API Connector

El autor solo ofrece un instalador para la app de Claude de escritorio

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar FISCAi Octopus API Connector

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

VS Code todavía no puede conectar FISCAi Octopus API Connector

El autor solo ofrece un instalador para la app de Claude de escritorio

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar FISCAi Octopus API Connector

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa FISCAi Octopus API Connector💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Valores que debes completar

  • OCTOPUS_SOFTWARE_HOUSE_UUID secreto obligatorio env
    UUID that Octopus assigns to your software (header softwareHouseUuid). Secret.
    Ver original en inglésUUID die Octopus aan uw software toekent (header softwareHouseUuid). Geheim.
  • OCTOPUS_USER secreto obligatorio env
    Nombre de usuario (correo electrónico) del usuario de Octopus con acceso a la API. Secreto.
    Ver original en inglésGebruikersnaam (e-mail) van de Octopus-gebruiker met API-toegang. Geheim.
  • OCTOPUS_PASSWORD secreto obligatorio env
    Wachtwoord van die gebruiker. Alleen in het geheugen; nooit gelogd. Geheim.
  • OCTOPUS_CACHE_KEY secreto obligatorio env
    Opcional, mínimo 16 caracteres: cifra la caché local y la sincronización en disco. Sin clave, solo se guarda en memoria. Secreto.
    Ver original en inglésOptioneel, minstens 16 tekens: versleutelt de lokale cache en synchronisatie op schijf. Zonder sleutel alleen in het geheugen. Geheim.
  • OCTOPUS_LOCALE_ID env
    localeId voor het dossiertoken (0-4, standaard 1; verifieer actuele regel).
  • OCTOPUS_ALLOWED_DOSSIERS env
    Opcional: IDs de carpeta separados por comas; las demás carpetas serán rechazadas.
    Ver original en inglésOptioneel: komma-gescheiden dossier-id's; andere dossiers worden geweigerd.
  • OCTOPUS_QUOTA_RESERVE env
    Número de llamadas por endpoint que el conector reserva (predeterminado 0).
    Ver original en inglésAantal calls per endpoint dat de connector vrijhoudt (standaard 0).
  • OCTOPUS_AMOUNTS_MODE env
    movement (beweging per periode, standaard) of cumulative. Verifieer actuele regel met de controle in de dossieroverdracht.
  • OCTOPUS_WRITE_ENABLED env
    Off by default. Only true enables the two-step write tools.
    Ver original en inglésStandaard uit. Alleen true zet de tweestaps-schrijftools aan.
  • OCTOPUS_WRITE_MAX_PER_DAY env
    De 1 a 200, por defecto 20.
    Ver original en inglés1 tot 200, standaard 20.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Licenciai
Apache-2.0
Conexión
Se ejecuta en tu computadora
Última versióni
1.0.0
Publicado en el registroi
21 nov 2026
Último cambio de códigoi
21 nov 2026
Creador
MnrAlci
Paquetes
mcpb: …/fiscai-octopus-api-connector-1.0.0.mcpb
Sitio web
github.com
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 21 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub MnrAlci, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hoy

  • ✓ Superada

    Tiene licencia

    Usa Apache-2.0

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

No revisado: solo se pueden revisar paquetes npm y PyPI con versión

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/mnralci-fiscai-octopus-api-connector.svg)](https://mcp.popnx.com/en/servers/mnralci-fiscai-octopus-api-connector)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Contabilidad, finanzas e impuestosi

  • Más estrellas que el 0% de los otros 3609 servidores de esta categoría
  • Publicado en el registro más recientemente que el 95% de los otros 3609 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 3609 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro FISCAi Octopus API Connector?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: OCTOPUS_SOFTWARE_HOUSE_UUID, OCTOPUS_USER, OCTOPUS_PASSWORD, OCTOPUS_CACHE_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hoy, y la última versión (1.0.0) llegó al registro hoy.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas MCPB en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

de SolidInvoiceEn crecimiento★ 989Actualizado hace 12 días

Se ejecuta en la nube✓ del servicio · solidinvoice.co

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

de CursivezEn crecimiento★ 265Actualizado hace 13 días

Se ejecuta en la nube✓ del servicio · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

de bex-coEn crecimiento★ 723 Estrellas de todo el repositorioActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · beancount.io

Twelve Data

Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.

de twelvedataEn crecimiento★ 87Actualizado hace 17 días

Se ejecuta en la nube✓ del servicio · twelvedata.com
Comparado con otros parecidos
Este
FISCAi Octopus API Connector
SolidInvoiceJournalitBeancount.ioTapetide - Indian Stock Market MCPTwelve Data
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoSíNo
Se añade con + en ClaudeNoNoNoNoNoSí
Revisiones básicas3/34/64/44/45/54/4
LicenciaApache-2.0MITNOASSERTIONMITMIT–
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

FISCAi Octopus API Connector Plugin for Grok Bot, also works in Copilot, Claude, Cursor, Windsurf and other MCP clients

Read-only access to the Octopus accounting REST API, built around its very low daily limits: cache first, sync through the modified-since endpoints, never a paid plan.

Nederlands · Tools · Manual · Changelog

Powered by FISCALCI Accounting & Tax (Askin Alci)

Author: Askin Alci

Belgium. Made for Belgian accountants and bookkeepers: it follows the Belgian chart of accounts (MAR) and Belgian VAT. Outside Belgium, check the local rules yourself.

Not yet tested against a live Octopus dossier. This connector has only been tested against a mocked API built from the official specification (there is no Octopus sandbox). Feedback and findings are welcome through GitHub issues. Open points: docs/OPEN-QUESTIONS.md.

Nederlandse samenvatting. Bedoeld voor Belgische boekhouders/accountants; gebaseerd op Belgische boekhoud- en btw-regels (MAR, Belgisch btw-stelsel). Gebruik buiten België: verifieer zelf de lokale regels. Zie README.nl.md.

About

FISCAi Octopus API Connector is a local MCP server (stdio) and command-line tool that lets Grok Bot and other MCP clients read Octopus dossiers: fiscal years, journals, chart of accounts, balances per period, booking lines, customers and suppliers, open items and reports. On top of that it builds what the API does not offer directly (a trial balance, ageing, MAR key figures) and produces exports and a dossier transfer package per fiscal year for the next accountant. Status: 1.0.0, tested offline against a mocked API built from the official specification; not yet validated against a live Octopus dossier (see open questions).

Contents

What it does · Daily limits · Install · Configuration · Security · Tools · Limitations · License

More. Setup · Manual (EN) · Handleiding (NL) · CLI · Hooks · Automation · Dossier transfer · Export schema · Integrations · Postman · Write mode · Operations · Privacy and data flow · Troubleshooting · Open questions · Agents

What it does

  • 49 read-only tools (51 with the optional write mode): dossiers, fiscal years, journals, chart of accounts, balances, booking lines, relations, open items, history reports, invoices, delivery notes, reminders, master data.
  • Trial balance built from accounts and balances per period, because Octopus has no trial-balance endpoint; with a balance check and totals per MAR class.
  • Analyses: ageing of open items, MAR key figures (revenue, costs, result, cash, receivables, payables, VAT indication), comparison with the previous fiscal year.
  • Local sync through the official modified-since endpoints: one full load, then only changes. Encrypted on disk with your own key, or memory only.
  • Export to CSV, JSON, Excel (xlsx) and Parquet for Power BI, Excel, databases and notebooks.
  • Dossier transfer per fiscal year: chart of accounts, closing trial balance, booking lines, open items at year end, journals, relations, VAT codes, CONTROL.md checks and MANIFEST.json with SHA-256, resumable when a daily limit is hit.
  • Automation: meeting preparation and recurring obligations (VAT, listings, annual accounts) as overviews and draft e-mails; nothing is sent by default.
  • Free official helpers (optional): Belgian VAT-number check (offline modulo 97, optional VIES of the European Commission) and ECB euro reference rates.

Daily limits and how the connector copes

The official Octopus REST specification sets a maximum number of calls per day per endpoint. Some are very low:

Endpoint groupCalls per day
Accounts, VAT codes, currencies, cost centres, custom fields, products, product groups; relations without search2
One purchase/sales or financial/miscellaneous booking10
Fiscal years, journals, reports (open items, history)24
All *modified-since* endpoints48
Dossier list and dossier token150
Relations with a search term, invoices, delivery notes, reminders400

So the connector:

  1. counts every call before sending it and refuses when today's limit (Europe/Brussels) is reached, instead of letting Octopus send you a warning e-mail (octopus_quota shows what is left);
  2. caches responses according to the limit (12 hours for 2/day master data);
  3. syncs accounts, balances, relations and bookings with the modified-since endpoints (first load per fiscal year and journal type with 1980-01-01 00:00:00.000, then fiscal year -1 and journal type -1 with the last watermark), exactly as the specification describes;
  4. refreshes the 10-minute tokens (authentication token and dossier token) automatically, one minute before they expire, and retries once on HTTP 401;
  5. never uses the paid Management API, the file-import API or any paid plan.

Install

Requirements: Python 3.10+, httpx, cryptography (and pyarrow only for Parquet). Octopus API access: a software house UUID from Octopus and an Octopus user with API rights. There is no sandbox; use the demo dossier for testing (verifieer actuele regel).

Grok Bot. Add the plugin from its repository and fill in the variables OCTOPUS_SOFTWARE_HOUSE_UUID, OCTOPUS_USER and OCTOPUS_PASSWORD (secrets). Then ask, for example: *"Show the trial balance of dossier 101 for 2026"* (example dossier number).

Command line.

pip install -r requirements.txt

python server/run_cli.py config init # writes a .env with placeholders only python server/run_cli.py doctor # checks Python, dependencies and configuration; makes no call python server/run_cli.py call octopus_dossiers python server/run_cli.py sync --dossier 101 --bookyear 2 python server/run_cli.py call octopus_proefbalans dossier_id=101 jaar=2026 python server/run_cli.py transfer --dossier 101 --out ./overdracht # estimate first; add --yes to run

Other MCP clients (Cursor, Claude Desktop/Code, VS Code Copilot, Windsurf): see examples/ for ready-made configuration files; they all start server/run_server.py over stdio.

Configuration

VariableMeaning
OCTOPUS_SOFTWARE_HOUSE_UUIDSoftware house UUID (header softwareHouseUuid). Secret.
OCTOPUS_USER, OCTOPUS_PASSWORDOctopus user with API access. Secret; memory only, never logged.
OCTOPUS_CACHE_KEYOptional, 16+ characters: encrypts cache and sync on disk. Without it everything stays in memory.
OCTOPUS_LOCALE_IDlocaleId for the dossier token (0-4, default 1; verifieer actuele regel).
OCTOPUS_ALLOWED_DOSSIERSOptional comma-separated allow-list of dossier ids.
OCTOPUS_QUOTA_RESERVECalls per endpoint kept in reserve (default 0).
OCTOPUS_AMOUNTS_MODEmovement (default) or cumulative: how balances per period are read (verifieer actuele regel).
OCTOPUS_WRITE_ENABLEDOff by default. true adds the two-step write tools.
OCTOPUS_DATA_DIR, OCTOPUS_HOOKS_FILE, OCTOPUS_LOG_LEVELData folder, hooks file, log level.

Security and safety

  • Read-only by default. Write tools do not exist unless OCTOPUS_WRITE_ENABLED=true; even then every write is a proposal first and needs a confirmation code, with a daily maximum. Delete operations are never offered. See WRITE.md.
  • Your credentials, your computer. No central server. Tokens live in memory only; secrets are scrubbed from every output, log and error.
  • Only the official host. The base URL must be https://service.inaras.be/octopus-rest-api/...; the Management API is refused.
  • No client data in this repository. Examples use [Voorbeeld] data only.
  • No tax or legal advice: check figures against the source and the current rules.

Tools

See docs/TOOLS.md for all tools with their Octopus endpoint and daily limit (generated from the code).

Limitations

  • Not yet validated against a live Octopus dossier; several API details are marked verifieer actuele regel and listed in docs/OPEN-QUESTIONS.md (for example whether balances per period are movements or cumulative, and the exact error object).
  • No pagination in the API: large lists come in one response; tools cap what they show (max_rijen), exports always contain everything.
  • Attachments (file sync), OAuth and a dashboard widget are on the roadmap.

Shared core

The reusable parts (MCP server, CLI base, hooks, export layer, automation, dossier-transfer package, token cache, daily-limit counter, encrypted store, trial-balance builder, analyses) live in FISCAi Accounting API Core and are vendored in server/vendor/accounting_api_core (python scripts/sync_core.py).

License

Apache License 2.0, see LICENSE and NOTICE. The attribution "Powered by FISCALCI Accounting & Tax (Askin Alci)" must stay intact in every copy and in generated exports.

Octopus is a trademark of its owner; this project is not endorsed by it.

Powered by FISCALCI Accounting & Tax (Askin Alci)