ABRA Flexi MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ABRA Flexi MCP Server list overdue invoices"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ABRA Flexi MCP Server
Local stdio MCP server for ABRA Flexi / FlexiBee accounting workflows. It is intended for agent clients such as Codex, Claude Desktop, or any MCP-compatible local runtime that can launch a Node process.
This is the standalone MCP project. The separate remote ChatGPT App project is here: vvitovec/abra-flexi-chatgpt-app.
What It Does
connects to ABRA Flexi over the official REST API
reads companies, evidence metadata, records, partners, products, balances, overdue items, and accounting summaries
prepares accountant-focused document drafts
supports guarded write flows with validation, dry-run style checks, confirmations, and an audit log
keeps Flexi credentials out of prompts and MCP tool arguments
Related MCP server: sevdesk-mcp
Safety Model
The server is configured through flexi.config.json profiles. Each profile controls:
Flexi base URL and company slug
test or production mode
default response format
which env vars contain credentials
read, dry-run, and write evidence allowlists
whether writes require confirmation
Writes are not free-form passthrough calls. Tool handlers build known payloads, validate them, enforce evidence permissions, and record request audit files under .flexi-harness/logs.
Setup
npm install
cp .env.example .envEdit .env with a dedicated ABRA Flexi REST API user:
FLEXI_PROD_USERNAME=api-user
FLEXI_PROD_PASSWORD=replace-meThen edit flexi.config.json:
{
"defaultProfile": "prod",
"profiles": {
"prod": {
"baseUrl": "https://example.flexibee.eu",
"company": "example_company_s_r_o_",
"usernameEnv": "FLEXI_PROD_USERNAME",
"passwordEnv": "FLEXI_PROD_PASSWORD"
}
}
}Run Locally
npm run devFor a production-style build:
npm run build
npm startCodex MCP Config
After building, add a server entry like this to your Codex config:
[mcp_servers.abra_flexi]
command = "node"
args = ["/absolute/path/to/abra-flexi-mcp-server/dist/index.js"]
enabled = trueThe server loads .env and flexi.config.json from the project directory.
Main Tool Areas
company and evidence discovery
flexible read-only evidence queries
partner and product search
invoice, payable, receivable, bank, cash, and internal document workflows
overdue and saldo summaries
accountant-first draft creation and guarded posting
latest-error explanation from the local audit log
Verification
npm run check
npm test
npm run buildThe tests use mocked HTTP servers and fixture-style responses. They do not need real ABRA Flexi credentials.
Related Docs
Available Tools
29 toolscreate_document_draftCreate document draftC
Create a draft accounting document and return a short confirmation payload.
Inputs: kind (required), partner_id (required), note, items, +8 more.
flexi_check_connectionCheck Flexi connectionA
Verify auth and basic company access. Use before the first real workflow.
Inputs: company, profile.
flexi_describe_evidenceDescribe evidenceC
Show compact schema metadata for one evidence. Detail lists are opt-in.
Inputs: evidence (required), company, profile, field_limit, +2 more.
flexi_execute_writeExecute writeC
Execute a prepared write and return a short confirmation payload.
Inputs: payload (required), evidence (required), confirmation_id (required), company, +3 more.
flexi_explain_last_errorExplain last errorB
Summarize the latest failed request from the audit log.
Inputs: no named parameters.
flexi_get_record_detailGet record detailC
Fetch one record detail. Relations and child collections are opt-in.
Inputs: id (required), evidence (required), company, profile, +2 more.
flexi_get_record_summaryGet record summaryC
Fetch one record with a small business summary.
Inputs: id (required), evidence (required), company, profile.
flexi_list_evidenceList evidenceB
Browse evidence catalog with small summaries. Use before search or writes.
Inputs: limit, query, offset, company, +2 more.
flexi_list_profilesList Flexi profilesB
List configured profiles and their write mode.
Inputs: no named parameters.
flexi_prepare_writePrepare writeC
Create a short-lived confirmation token for a validated write.
Inputs: payload (required), evidence (required), company, profile, +4 more.
flexi_search_recordsSearch recordsD
Search one evidence and return short record summaries. Query or filter is required.
Inputs: no named parameters.
flexi_validate_importValidate importB
Run a dry-run import and return only compact validation feedback.
Inputs: payload (required), evidence (required), company, profile, +2 more.
get_accounting_overviewGet accounting overviewC
Return a compact dashboard for unpaid receivables and payables.
Inputs: date, company, profile, include_overdue.
get_document_detailGet document detailA
Fetch one accounting document detail. Extra sections are opt-in.
Inputs: id (required), kind (required), company, profile, +4 more.
get_document_summaryGet document summaryC
Fetch one accounting document with a small business summary.
Inputs: id (required), kind (required), company, profile.
get_partner_balance_summaryGet partner balance summaryC
Return compact saldo totals for one partner.
Inputs: partner_id (required), date, company, profile.
get_partner_detailGet partner detailC
Fetch one partner detail. Bank accounts and contacts are opt-in.
Inputs: id (required), company, profile, include_contacts, +1 more.
get_partner_summaryGet partner summaryC
Fetch one partner with a small business summary.
Inputs: id (required), company, profile.
get_product_summaryGet product summaryC
Fetch one product from the price list.
Inputs: id (required), company, profile.
post_documentPost documentC
Finalize a supported accounting document by locking it.
Inputs: id (required), kind (required), company, profile.
search_documentsSearch documentsC
Search accounting documents by business filters and return short summaries.
Inputs: kind (required), limit, query, due_to, +10 more.
search_overdue_itemsSearch overdue itemsC
List overdue receivables or payables with compact report summaries.
Inputs: date, limit, scope, offset, +3 more.
search_partnersSearch partnersC
Find customers or suppliers and return short partner summaries.
Inputs: query (required), role, limit, offset, +2 more.
search_productsSearch productsC
Find products from the price list and return short summaries.
Inputs: query (required), limit, offset, company, +2 more.
search_reference_valuesSearch reference valuesC
Search compact lookup values such as document types, payment methods, or centers.
Inputs: kind (required), limit, query, offset, +2 more.
search_unpaid_documentsSearch unpaid documentsC
Find unpaid or overdue receivables and payables with compact summaries.
Inputs: kind (required), limit, offset, company, +3 more.
update_document_headerUpdate document headerC
Update common header fields on one accounting document.
Inputs: id (required), kind (required), changes (required), company, +1 more.
update_document_itemsUpdate document itemsC
Replace all items on one accounting document.
Inputs: id (required), kind (required), items (required), company, +1 more.
validate_documentValidate documentB
Dry-run validate the latest stored draft snapshot for one document.
Inputs: kind (required), id, company, profile.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
Many tools have distinct roles but there is overlap between flexi_get_record_detail and get_document_detail, and similar pairs. The descriptions help, but the prefix split adds ambiguity.
Inconsistent use of 'flexi_' prefix on some tools while others use plain snake_case. Patterns like 'get_partner_summary' vs 'flexi_get_record_summary' break uniformity.
29 tools is high but covers a broad domain. Each tool seems justified, but the count could be reduced by consolidating similar summary/detail pairs.
Document workflow is well-covered (create, update, validate, post) but missing delete/cancel. Partners and products only have read/search, lacking create/update/delete.
Maintenance
Related MCP Connectors
MCP server for ABRA Flexi — accounting, contacts, stock and draft-checked invoice creation.
Read invoices, journals and accounts; create customers, items and unposted invoices in Briox.
Read and create Vyfakturuj invoices and contacts: search, number series, payment methods, tags.
Read SuperFaktura invoices, clients, expenses, bank and stock; create clients, expenses and drafts.
Related MCP Servers
- AlicenseBqualityBmaintenanceProvides a comprehensive MCP interface to the AbraFlexi ERP REST API, enabling management of invoices, contacts, products, bank transactions, and other evidence through natural language.683MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with the sevDesk accounting API for managing contacts, invoices, credit notes, orders, vouchers, transactions, and parts.24 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying products and stock, sales orders, contacts, invoices, payables/receivables, and creating contacts through the official ERP API.MIT
- AlicenseBqualityCmaintenanceEnables MCP clients to read invoices, supplier invoices, vouchers, financial reports, and AR/AP ageing from a Swedish accounting system, with optional draft-only write tools for customers, offers, orders, and unsent invoice drafts after confirmation. It also exposes many other read endpoints through a safety allowlist.261MIT