AbraFlexi MCP Server
An MCP server for AbraFlexi that exposes accounting REST operations, read-only by default, for one bound company across dedicated and generic evidence tools.
Identify the bound company/URL and read-only status, and list available evidences.
Retrieve, create, update, and delete issued invoices; retrieve and create received invoices.
Handle invoice business logic: payment matching, cash payment, advance/ZDD deductions, ZDD linking, overdue days, and recipient emails.
Manage contacts/companies and products (get/create/update/delete), and retrieve/create bank transactions.
Operate on any evidence generically: get, create, update, delete, list, inspect properties/reports/relations, sum totals, and view record history.
Perform document and batch operations: lock/unlock, accountant lock, storno, custom actions, mass updates, and batch insert/update.
Work with attachments: attach local files, list/get metadata, download files or thumbnails, and delete attachments.
Export PDF/XLSX reports, get payment QR codes, call saved user queries, and manage record labels.
Enable, disable, check, and page through the Changes API for incremental sync.
Create a new AbraFlexi company with admin privileges and call public python-abraflexi client methods through a bridge.
All write operations depend on READ_ONLY, which defaults to true.
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., "@AbraFlexi MCP Server show me all issued invoices from last month"
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.
AbraFlexi MCP Server
A comprehensive Model Context Protocol (MCP) server for AbraFlexi integration using FastMCP and python-abraflexi. This server provides complete access to AbraFlexi REST API functionality through MCP-compatible tools.
Features
69 tools in total, covering the full REST surface exposed by
python-abraflexi:
dedicated tools for the most common evidences (invoices, contacts,
products, bank transactions), plus generic evidence_* tools that work
against any AbraFlexi evidence by name.
One server process = one AbraFlexi company. A running server is bound for its whole lifetime to a single company, set via
ABRAFLEXI_URL/ABRAFLEXI_COMPANY(see Configuration). Every record any tool returns already belongs to that company - it is not possible to ask this server for another company's data. Callserver_infoto check which company/URL a running server is bound to; the main record-fetching tools (invoice_issued_get,invoice_received_get,contact_get,product_get,bank_transaction_get,evidence_get,changes_get) also echo it back in a_contextblock on every response, together with a note clarifying any counterparty fields on the records (e.g. an invoice'snazFirmyis the customer/supplier, not the company that issued/received it).
ℹ️ Server Identity
server_info- Report which AbraFlexi company/URL this server session is bound to
📄 Invoice Management
invoice_issued_get- Retrieve issued invoices (faktura-vydana)invoice_issued_create- Create new issued invoicesinvoice_issued_update- Update existing issued invoicesinvoice_issued_delete- Remove issued invoicesinvoice_received_get- Retrieve received invoices (faktura-prijata)invoice_received_create- Create new received invoices
💳 Issued Invoice Business Logic
invoice_issued_match_payment- Match an invoice against a payment document (Párování plateb)invoice_issued_cash_payment- Pay an invoice in cash (Hotovostní úhrada)invoice_issued_deduct_advance- Deduct an advance invoice (Odpočet záloh a ZDD)invoice_issued_deduct_zdd- Deduct an advance tax document, ZDD (Odpočet záloh a ZDD)invoice_issued_link_zdd- Link a ZDD to an income payment (Vazby ZDD)invoice_issued_unlink_zdd- Remove a ZDD bonding (Vazby ZDD)invoice_issued_overdue_days- Compute days overdue from a due date (pure, no API call)invoice_issued_get_email- Resolve the best recipient email for an invoiceinvoice_issued_get_recipients- Resolve all recipient emails for an invoice
🏢 Company Management
company_create- Found a brand-new AbraFlexi company (accounting unit) - requires server-admin/license REST rights
👥 Contact Management
contact_get- Retrieve contacts and companies (adresar)contact_create- Create new contactscontact_update- Update existing contactscontact_delete- Remove contacts
☎️ Contact Convenience Lookups
contact_get_notification_email- Best email to notify (primary/purpose-matching contact)contact_get_cell_phone- Cell phone number to usecontact_get_any_phone- Any usable phone number (mobile preferred over landline)contact_get_bank_accounts- Registered bank account(s) for a contact
📦 Product Management
product_get- Retrieve products from price list (cenik)product_create- Create new productsproduct_update- Update existing productsproduct_delete- Remove products
🏦 Bank Transaction Management
bank_transaction_get- Retrieve bank transactions (banka)bank_transaction_create- Create new bank transactions
🔧 Generic Evidence Operations
evidence_get- Get records from any evidence (filter, pagination, sorting, relations)evidence_create- Create record in any evidenceevidence_update- Update record in any evidence (supportsremove_external_ids)evidence_delete- Delete record from any evidenceevidence_list- List all evidences available on the bound company (liveevidence-list.json)
🧠 Python-abraflexi Bridge
abraflexi_client_methods- List public methods of core python-abraflexi clients (ReadOnly,ReadWrite,Changes,Adresar,FakturaVydana)abraflexi_client_call- Invoke a selected public client method with arguments (write methods still respectREAD_ONLY)
🔒 Locking, Actions & Batch Operations
evidence_lock/evidence_unlock/evidence_lock_for_ucetni- Lock/unlock a recordevidence_storno- Cancel (storno) a document recordevidence_perform_action- Call a record's dedicated business action (e.g.pay)evidence_mass_update- Update, or act on, every record matching a filter (Dávkové operace)evidence_batch_insert/evidence_batch_update- Insert/update many records in one request
📎 Attachments
evidence_attach_file- Attach a local file to any recordevidence_list_attachments- List a record's attachmentsevidence_get_attachment- Get metadata for a single attachmentevidence_download_attachment- Download an attachment to a local fileevidence_get_attachment_thumbnail- Download an image attachment's thumbnailevidence_delete_attachment- Delete an attachment
🧾 Reports, QR Codes & User Queries
evidence_export_report- Export a PDF/XLSX report for a record or evidence listingevidence_get_qr_code- Get a document's payment QR code (file or base64 data URI)user_query_list- List saved user-defined queries (uzivatelsky-dotaz)call_user_query- Call a saved user-defined query (uživatelský dotaz)
ℹ️ Evidence Metadata & Summation
evidence_get_properties- List the fields supported by an evidenceevidence_get_reports- List the printable reports available for an evidenceevidence_get_relations_list- List the sub-evidences (relations) available for an evidenceevidence_get_sum- Get summation (totals) for an evidenceevidence_get_record_changes- Get a single record's change history
🏷️ Labels (štítky)
evidence_get_labels- Get labels assigned to a recordevidence_set_label- Add a labelevidence_unset_label- Remove specific label(s)evidence_unset_labels- Remove all labels
🔄 Changes API (company-wide incremental sync)
changes_enable/changes_disable- Toggle change trackingchanges_status- Check whether change tracking is enabledchanges_get- Page through recorded changes since a given version
🪝 Web Hooks (push notifications about changes)
AbraFlexi POSTs the changes since the previous call to every registered hook URL
(same body as the Changes API, usually within seconds, not counted towards the
API request limit). Hooks need the Changes API enabled for the company
(changes_enable) and, on self-hosted servers, enableHooks=true in
flexibee-server.xml. A hook cannot be filtered by evidence: the receiver gets
every change. See the AbraFlexi API docs, Web Hooks.
Tool | Purpose | Annotation class |
| List registered hooks of the bound company | read-only |
| One hook incl. its current failure penalty | read-only |
| Register a hook ( | create (not idempotent, check |
| Remove a hook | destructive, idempotent |
| Reset the failure penalty and call the URL now | create-like (not idempotent) |
Write tools respect READ_ONLY (default true). A hook delivers every change
of the company to its receiver, so set ABRAFLEXI_WEBHOOK_ALLOWED_HOSTS
(comma-separated host names, *.example.com allowed) to restrict where
webhook_register may point hooks; when unset any http(s) host is accepted.
sec_key is sent to AbraFlexi
as the X-FB-Hook-SecKey secret and is masked in every tool response and error
message. Only absolute http(s) URLs without embedded credentials are accepted.
Related MCP server: wefact-mcp
Installation
Prerequisites
Python 3.10 or higher
Access to an AbraFlexi server with API enabled
Option 1: Install from PyPI (Recommended)
pip install abraflexi-mcp-serverThen run the server:
abraflexi-mcpOption 2: AppImage (Linux)
Download the self-contained AppImage from the latest release:
chmod +x AbraFlexi-MCP-Server-*-x86_64.AppImage
./AbraFlexi-MCP-Server-*-x86_64.AppImageNo Python or pip required. See AppImage section for details.
Option 3: Install from Source
Clone the repository:
git clone https://github.com/VitexSoftware/abraflexi-mcp-server.git cd abraflexi-mcp-serverInstall with uv (recommended):
uv sync uv run python scripts/start_server.pyOr with pip:
pip install -e . abraflexi-mcp
Cloud Deployment
A testing deployment is available at:
🌐 https://abraflexi.fastmcp.app/mcp
This cloud-hosted instance allows you to test and use the AbraFlexi MCP server without local installation. Configure your MCP client to connect to this endpoint with HTTP transport.
Note: This is a testing deployment. For production use, we recommend self-hosting using one of the installation methods above.
Configuration
Create a .env file or set environment variables:
cp .env.example .env
# Edit .env with your AbraFlexi server detailsConfiguration
Required Environment Variables
ABRAFLEXI_URL- Your AbraFlexi server URL (e.g.,https://demo.flexibee.eu:5434)ABRAFLEXI_COMPANY- Company identifier (e.g.,demo_de)
Authentication (choose one method)
Method 1: Username/Password (Recommended)
ABRAFLEXI_LOGIN- Your AbraFlexi usernameABRAFLEXI_PASSWORD- Your AbraFlexi password
Method 2: Session ID
ABRAFLEXI_AUTHSESSID- Your AbraFlexi session ID
Optional Configuration
READ_ONLY- Set totrue,1, oryesto enable read-only mode (default:true)ABRAFLEXI_WEBHOOK_ALLOWED_HOSTS- Optional comma-separated allowlist of host nameswebhook_registermay use as hook receivers, e.g.multiflexi.vitexsoftware.com,*.spoje.net(default: unrestricted)ABRAFLEXI_TIMEOUT- Request timeout in seconds (default:300)
Transport Configuration
ABRAFLEXI_MCP_TRANSPORT- Transport type:stdio(default) orstreamable-http
HTTP Transport Configuration (only used when ABRAFLEXI_MCP_TRANSPORT=streamable-http):
ABRAFLEXI_MCP_HOST- Server host (default:127.0.0.1)ABRAFLEXI_MCP_PORT- Server port (default:8000)ABRAFLEXI_MCP_STATELESS_HTTP- Stateless mode (default:false)AUTH_TYPE- Must be set tono-authfor streamable-http transport
Usage
Running the Server
With startup script (recommended):
uv run python scripts/start_server.pyDirect execution:
uv run python -m abraflexi_mcp_server.serverCLI help:
abraflexi-mcp --helpTransport Options
The server supports two transport methods:
STDIO Transport (Default)
Standard input/output transport for MCP clients like Claude Desktop:
# Set in .env or environment
ABRAFLEXI_MCP_TRANSPORT=stdioHTTP Transport
HTTP-based transport for web integrations:
# Set in .env or environment
ABRAFLEXI_MCP_TRANSPORT=streamable-http
ABRAFLEXI_MCP_HOST=127.0.0.1
ABRAFLEXI_MCP_PORT=8000
ABRAFLEXI_MCP_STATELESS_HTTP=false
AUTH_TYPE=no-authTesting
Run test suite:
uv run python scripts/test_server.pyRead-Only Mode
When READ_ONLY=true (default), the server will only expose GET operations (retrieve data) and block all create, update, and delete operations. This is useful for:
📊 Monitoring dashboards
🔍 Read-only integrations
🔒 Security-conscious environments
🛡️ Preventing accidental modifications
To enable write operations, set READ_ONLY=false in your .env file.
Example Tool Calls
Get all issued invoices:
invoice_issued_get(limit=10)Get specific invoice by code:
invoice_issued_get(kod="INV-2024-001")Count invoices issued in August 2026 (without downloading full records):
invoice_issued_get(
datum_vystaveni_od="2026-08-01",
datum_vystaveni_do="2026-08-31",
detail="id",
add_row_count=True
)Create a new contact:
contact_create(
kod="CUSTOMER01",
nazev="Example Company s.r.o.",
email="info@example.com",
tel="+420123456789"
)Get products:
product_get(nazev="Widget", limit=5)Generic evidence query (with pagination/sorting):
evidence_get(
evidence="faktura-vydana",
filter_expr="datVyst >= '2024-01-01'",
order="datVyst",
order_direction="D",
limit=20,
start=0
)Attach a local file to any record:
evidence_attach_file(evidence="cenik", kod="PRODUCT01", filepath="/path/to/photo.jpg")Lock an invoice, then export its PDF:
evidence_lock(evidence="faktura-vydana", kod="INV-2024-001")
evidence_export_report(
evidence="faktura-vydana",
kod="INV-2024-001",
output_path="/tmp/invoice.pdf",
report_name="dodaciList"
)Mass-update every price-list item from a supplier:
evidence_mass_update(
evidence="cenik",
filter_expr="dodavatel = 'code:SUPPLIER01'",
data={"stitky": "code:VIP"}
)Incremental sync via the Changes API:
changes_enable()
page = changes_get(start=0, limit=500, evidences=["faktura-vydana"])
# page["changes"], page["next"], page["global_version"]MCP Integration
This server is designed to work with MCP-compatible clients like Claude Desktop. See MCP_SETUP.md for detailed integration instructions.
OCI Container
The server can be run as an OCI container (Docker/Podman) — no Python installation needed on the host.
Building the image
podman build -t abraflexi-mcp-server -f Containerfile .Running the container
The image defaults to streamable-http transport on port 8000.
With individual environment variables:
podman run --rm -p 8000:8000 \
-e ABRAFLEXI_URL=https://demo.flexibee.eu:5434 \
-e ABRAFLEXI_COMPANY=demo_de \
-e ABRAFLEXI_LOGIN=winstrom \
-e ABRAFLEXI_PASSWORD=winstrom \
abraflexi-mcp-serverWith an env file:
podman run --rm -p 8000:8000 --env-file .env abraflexi-mcp-serverContainer environment defaults
Variable | Default |
|
|
|
|
|
|
|
|
All other configuration variables can be passed as environment variables.
AppImage
A self-contained, single-file Linux executable — no Python, pip, or any other dependency required on the host.
Building the AppImage
bash appimage/build-appimage.shThe script downloads a portable CPython and appimagetool automatically. The resulting file is placed in build/appimage/:
build/appimage/AbraFlexi-MCP-Server-<version>-x86_64.AppImageRunning the AppImage
The AppImage automatically loads a .env file from the current working directory if one is present.
With a .env file (recommended):
cp .env.example .env
# edit .env with your credentials
./AbraFlexi-MCP-Server-*-x86_64.AppImageWith inline environment variables:
ABRAFLEXI_URL=https://demo.flexibee.eu:5434 \
ABRAFLEXI_COMPANY=demo_de \
ABRAFLEXI_LOGIN=winstrom \
ABRAFLEXI_PASSWORD=winstrom \
./AbraFlexi-MCP-Server-*-x86_64.AppImageDevelopment
Project Structure
abraflexi-mcp-server/
├── abraflexi_mcp_server/
│ ├── __init__.py
│ └── server.py # Main server implementation
├── tests/
│ ├── live_capability_scenario.py # Live scenario against a real company
│ └── test_webhooks.py # Unit tests for the web hook tools (pytest)
├── appimage/
│ ├── AppRun # AppImage entry point
│ ├── abraflexi-mcp-server.desktop
│ ├── abraflexi-mcp-server.svg
│ └── build-appimage.sh # AppImage build script
├── debian/ # Debian packaging
│ ├── abraflexi-mcp-server.svg # AppStream stock icon
│ ├── abraflexi-mcp-server.install
│ └── cz.vitexsoftware.abraflexi-mcp-server.metainfo.xml
├── scripts/
│ ├── start_server.py # Startup script with validation
│ └── test_server.py # Test script
├── Containerfile # OCI container build
├── server.json # MCP Registry manifest
├── pyproject.toml # Python project configuration
├── setup.py # Legacy setuptools configuration
├── requirements.txt # Dependencies
├── .env.example # Environment configuration template
├── .env # Your configuration (not in git)
├── .gitignore # Git ignore patterns
└── README.md # This fileRunning Tests
# Tool registration + basic connectivity
uv run python scripts/test_server.py
# Unit tests (no AbraFlexi needed): web hook tools
python3 -m pytest tests/test_webhooks.py
# Live capability scenario (all read tools + READ_ONLY write guards)
# Official public demo (login winstrom / winstrom):
python tests/live_capability_scenario.py \
--url https://demo.flexibee.eu:5434 \
--company demo \
--login winstrom --password winstrom \
--json-out /tmp/abra-demo-live.json
# Private/dev company example:
python tests/live_capability_scenario.py \
--url https://flexibee-dev.spoje.net:5434 \
--company testa_invest_s_r_o_ \
--login "$ABRAFLEXI_LOGIN" --password "$ABRAFLEXI_PASSWORD" \
--json-out /tmp/abra-live.jsonExit code is non-zero when any non-skipped check fails.
Error Handling
The server includes comprehensive error handling:
✅ Authentication errors are clearly reported
🔒 Read-only mode violations are blocked with descriptive messages
✔️ Invalid parameters are validated
🌐 Network and API errors are properly formatted
📝 Detailed logging for troubleshooting
Security Considerations
🔑 Store credentials securely in
.envfile (never commit to git)🔒 Enable read-only mode for monitoring-only use cases
🛡️ Use HTTPS for AbraFlexi server connections
🔄 Regularly rotate passwords
📁 Ensure
.envfile has proper permissions (600)
Troubleshooting
Common Issues
Connection Failed:
Verify
ABRAFLEXI_URLis correct and accessibleCheck authentication credentials
Ensure AbraFlexi API is enabled
Check firewall/network settings
Permission Denied:
Verify user has sufficient AbraFlexi permissions
Check if read-only mode is enabled when trying to modify data
Tool Not Found:
Ensure all dependencies are installed:
uv syncVerify Python version compatibility (3.10+)
Debug Mode
Set environment variable for detailed logging:
export DEBUG=1
uv run python scripts/start_server.pyDependencies
FastMCP - MCP server framework
python-abraflexi - AbraFlexi Python library
python-dotenv - Environment variable management
License
This project is licensed under the MIT License.
Acknowledgments
AbraFlexi for the accounting platform
Model Context Protocol for the integration standard
FastMCP for the server framework
Support
Author
Vítězslav Dvořák
Email: info@vitexsoftware.cz
GitHub: @VitexSoftware
Made with ❤️ for the AbraFlexi and MCP communities
Available Tools
68 toolsabraflexi_client_callA
Call a public python-abraflexi client method through MCP.
This bridge tool is intended for advanced workflows not yet covered by dedicated MCP wrappers.
Inputs: method (required), client_class (required), init, company, +4 more. Returns: result
abraflexi_client_methodsB
List public python-abraflexi methods available via bridge calls.
Inputs: client_class, include_signatures. Returns: result
bank_transaction_createB
Create a new bank transaction in AbraFlexi.
Inputs: kod (required), banka (required), castka (required), datum_vystaveni (required), +5 more. Returns: result
bank_transaction_getA
Get bank transactions (banka) from AbraFlexi.
These are bank transactions belonging to the AbraFlexi company this server is bound to (see server_info).
Inputs: ids, limit, detail. Returns: result
call_user_queryB
Call a saved user-defined query (uzivatelsky dotaz).
Inputs: query_id (required), method, params. Returns: result
changes_disableA
Disable change tracking for the current company (Changes API).
Returns: str: JSON formatted result
Inputs: no named parameters. Returns: result
changes_enableB
Enable change tracking for the current company (Changes API).
Returns: str: JSON formatted result
Inputs: no named parameters. Returns: result
changes_getA
Get a page of company-wide recorded changes (Changes API), for incremental synchronization of external systems.
Changes are scoped to the AbraFlexi company this server is bound to (see server_info).
Inputs: limit, start, evidences. Returns: result
changes_statusA
Check whether change tracking is currently enabled for the current company.
Returns: str: JSON formatted status
Inputs: no named parameters. Returns: result
company_createA
Create a brand-new AbraFlexi company (accounting unit) at the server root.
Unlike every other *_create tool, this does NOT operate on the company configured via ABRAFLEXI_COMPANY - it calls the server-level "/admin/zalozeni-firmy" endpoint, which requires a REST user with server-admin/license-level rights (not just rights on one company).
Inputs: name (required), ic, vatid, country, +3 more. Returns: result
contact_createB
Create a new contact/company in AbraFlexi.
Inputs: kod (required), nazev (required), tel, email, +1 more. Returns: result
contact_deleteC
Delete a contact/company from AbraFlexi.
Inputs: id, kod. Returns: result
contact_getA
Get contacts/companies (adresar) from AbraFlexi.
These are address-book entries (customers, suppliers, other contacts) belonging to the AbraFlexi company this server is bound to (see server_info) - they are business partners of that company, not the company itself.
Inputs: ids, kod, limit, nazev, +1 more. Returns: result
contact_get_any_phoneA
Get any usable phone number for a contact, preferring mobile over landline.
Inputs: id, kod, purpose. Returns: result
contact_get_bank_accountsA
Get the bank account(s) registered for a contact.
Inputs: id, kod. Returns: result
contact_get_cell_phoneB
Get the cell phone number to use for a contact.
Inputs: id, kod, purpose. Returns: result
contact_get_notification_emailA
Get the email address to notify for a contact, preferring a primary/ purpose-matching contact over the address's own email.
Inputs: id, kod, purpose. Returns: result
contact_updateB
Update an existing contact/company in AbraFlexi.
Inputs: id, kod, data. Returns: result
evidence_attach_fileA
Attach a local file to a record in any AbraFlexi evidence.
Inputs: evidence (required), filepath (required), id, kod. Returns: result
evidence_batch_insertB
Insert multiple records into an evidence in a single request.
Inputs: records (required), evidence (required), atomic, dry_run. Returns: result
evidence_batch_updateC
Update multiple records in an evidence in a single request.
Inputs: records (required), evidence (required), atomic, dry_run. Returns: result
evidence_createB
Create a new record in any AbraFlexi evidence.
Inputs: data (required), evidence (required), company. Returns: result
evidence_deleteB
Delete a record from any AbraFlexi evidence.
Inputs: evidence (required), id, kod, company. Returns: result
evidence_delete_attachmentB
Delete an attachment from a record.
Inputs: evidence (required), attachment_id (required), id, kod. Returns: result
evidence_download_attachmentC
Download an attachment's raw content to a local file.
Inputs: evidence (required), output_path (required), attachment_id (required), id, +1 more. Returns: result
evidence_export_reportA
Export a printable report (PDF/XLSX) for a record, or the whole evidence listing, to a local file.
Inputs: evidence (required), output_path (required), id, kod, +4 more. Returns: result
evidence_getC
Get records from any AbraFlexi evidence.
Inputs: evidence (required), ids, limit, order, +7 more. Returns: result
evidence_get_attachmentA
Get metadata for a single attachment of a record.
Inputs: evidence (required), attachment_id (required), id, kod. Returns: result
evidence_get_attachment_thumbnailA
Download the thumbnail of an image attachment to a local file.
Inputs: evidence (required), output_path (required), attachment_id (required), id, +3 more. Returns: result
evidence_get_labelsA
Get all labels (stitky) currently assigned to a record.
Inputs: evidence (required), id, kod. Returns: result
evidence_get_propertiesA
Get the list of properties (fields) supported by an evidence.
Inputs: evidence (required). Returns: result
evidence_get_qr_codeA
Get the payment QR code for a document record.
Inputs: evidence (required), id, kod, size, +1 more. Returns: result
evidence_get_record_changesB
Get the change history (Prehled zmen zaznamu) of a single record.
Inputs: evidence (required), id, kod. Returns: result
evidence_get_relations_listB
Get the list of sub-evidences (relations) available for an evidence.
Inputs: evidence (required). Returns: result
evidence_get_reportsB
Get the list of printable reports available for an evidence.
Inputs: evidence (required). Returns: result
evidence_get_sumA
Get summation (totals) for an evidence, optionally filtered.
Inputs: evidence (required), conditions, filter_expr. Returns: result
evidence_listA
List all available AbraFlexi evidences.
Returns: str: JSON formatted list of evidence names
Inputs: no named parameters. Returns: result
evidence_list_attachmentsA
List attachments (prilohy) of a record in any AbraFlexi evidence.
Inputs: evidence (required), id, kod. Returns: result
evidence_lockA
Lock a record in any AbraFlexi evidence, preventing further changes until unlocked.
Inputs: evidence (required), id, kod. Returns: result
evidence_lock_for_ucetniC
Lock a record in any AbraFlexi evidence for the accountant (lock-for-ucetni).
Inputs: evidence (required), id, kod. Returns: result
evidence_mass_updateB
Update, or perform an action on, every record of an evidence matching a filter in a single request (Davkove operace).
Inputs: evidence (required), filter_expr (required), data, action. Returns: result
evidence_perform_actionA
Perform a custom business action on a record via its dedicated {id}/{action}.json URL (e.g. paying an invoice), as opposed to the body-level @action attribute used by evidence_lock/evidence_storno/etc.
Inputs: action (required), evidence (required), id, kod, +1 more. Returns: result
evidence_set_labelA
Add a label to a record, keeping its existing labels.
Inputs: label (required), evidence (required), id, kod. Returns: result
evidence_stornoC
Cancel (storno) a document record in any AbraFlexi evidence.
Inputs: evidence (required), id, kod. Returns: result
evidence_unlockB
Unlock a record in any AbraFlexi evidence.
Inputs: evidence (required), id, kod. Returns: result
evidence_unset_labelB
Remove specific label(s) from a record, keeping the rest.
Inputs: evidence (required), labels_to_remove (required), id, kod. Returns: result
evidence_unset_labelsB
Remove all labels from a record.
Inputs: evidence (required), id, kod. Returns: result
evidence_updateC
Update a record in any AbraFlexi evidence.
Inputs: evidence (required), id, kod, data, +2 more. Returns: result
invoice_issued_cash_paymentA
Pay an issued invoice in cash (Hotovostni uhrada).
Inputs: value (required), id, kod, extra_fields. Returns: result
invoice_issued_createC
Create a new issued invoice in AbraFlexi.
Inputs: kod (required), firma (required), polozky, extra_fields, +1 more. Returns: result
invoice_issued_deduct_advanceC
Deduct an advance invoice from a tax document invoice (Odpocet zaloh a ZDD).
Inputs: advance_invoice_id (required), id, kod, extra_fields. Returns: result
invoice_issued_deduct_zddC
Deduct an advance tax document (ZDD) from an issued invoice (Odpocet zaloh a ZDD).
Inputs: zdd_invoice_id (required), id, kod, extra_fields. Returns: result
invoice_issued_deleteB
Delete an issued invoice from AbraFlexi.
Inputs: id, kod. Returns: result
invoice_issued_getA
Get issued invoices (faktura-vydana) from AbraFlexi.
Every invoice returned was issued BY the AbraFlexi company this server is bound to (see server_info) - there is no way to query another company's invoices from this server. The 'nazFirmy'/'firma' fields on each record identify the CUSTOMER/counterparty being invoiced, not the issuer.
Inputs: ids, kod, limit, detail, +4 more. Returns: result
invoice_issued_get_emailB
Get the best recipient email address for an issued invoice.
Inputs: id, kod. Returns: result
invoice_issued_get_recipientsA
Get all recipient email addresses for an issued invoice.
Inputs: id, kod, purpose. Returns: result
invoice_issued_link_zddC
Link an advance tax document (ZDD) to an income payment (Vazby ZDD).
Inputs: income_id (required), id, kod, income_evidence. Returns: result
invoice_issued_match_paymentB
Match an issued invoice against a payment document (Parovani plateb).
Inputs: payment_id (required), id, kod, zbytek, +2 more. Returns: result
invoice_issued_overdue_daysA
Get the number of days an invoice is overdue by, given its due date. Pure date arithmetic - does not contact AbraFlexi.
Inputs: due_date (required). Returns: result
invoice_issued_unlink_zddA
Remove an advance tax document (ZDD) bonding from an issued invoice (Vazby ZDD).
Inputs: id, kod. Returns: result
invoice_issued_updateB
Update an existing issued invoice in AbraFlexi.
Inputs: id, kod, data. Returns: result
invoice_received_createC
Create a new received invoice in AbraFlexi.
Inputs: kod (required), firma (required), polozky, extra_fields, +1 more. Returns: result
invoice_received_getA
Get received invoices (faktura-prijata) from AbraFlexi.
Every invoice returned was received BY the AbraFlexi company this server is bound to (see server_info) - there is no way to query another company's received invoices from this server. The 'nazFirmy'/'firma' fields on each record identify the SUPPLIER/counterparty who issued the invoice, not the receiving company.
Inputs: ids, kod, limit, detail. Returns: result
product_createB
Create a new product in AbraFlexi.
Inputs: kod (required), nazev (required), cena, extra_fields. Returns: result
product_deleteB
Delete a product from AbraFlexi.
Inputs: id, kod. Returns: result
product_getA
Get products (cenik) from AbraFlexi.
These are price-list entries belonging to the AbraFlexi company this server is bound to (see server_info).
Inputs: ids, kod, limit, nazev, +1 more. Returns: result
product_updateB
Update an existing product in AbraFlexi.
Inputs: id, kod, data. Returns: result
server_infoA
Report which AbraFlexi company/instance this MCP server session is bound to.
This server is bound to exactly one AbraFlexi company for its whole process lifetime (configured via ABRAFLEXI_URL/ABRAFLEXI_COMPANY). Every other tool's results already belong to this company by construction. Call this tool first whenever the identity of "the company" matters to the request (e.g. "how many invoices did company X issue"), instead of trying to infer it from record fields such as an invoice's customer/supplier name.
Returns: str: JSON object with abraflexi_url, company, and read_only.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 68 tools
Some tools are clearly distinct, but there is meaningful overlap: evidence_get and the specific invoice_issued_get/contact_get/product_get wrappers cover the same ground, and invoice_issued_get_recipients vs invoice_issued_get_email as well as contact_get_cell_phone vs contact_get_any_phone are easily confused. The descriptions help, but an agent could reasonably select the wrong tool in several cases.
The dominant verb_noun pattern is consistent and readable, e.g. evidence_create, contact_update, invoice_issued_delete, changes_enable. Minor deviations such as server_info, abraflexi_client_methods, and abraflexi_client_call, plus singular/plural label variants, keep it from being a perfect 5.
68 tools is far above the 25+ threshold for a heavy toolset. While AbraFlexi is a broad ERP system, the surface is inflated by generic evidence_* tools coexisting with many specific wrappers and by numerous highly specialized invoice_issued_* actions that could reasonably be grouped or delegated to evidence_perform_action.
The toolset covers contact, product, invoice, bank, evidence, attachment, label, change-tracking, locking, storno, mass operations, reporting, QR codes, and user queries, which is quite thorough. Minor gaps like missing dedicated invoice_received_update/delete or bank_transaction_update/delete are workaroundable via the generic evidence_update/evidence_delete tools.
Maintenance
Related MCP Connectors
MCP server for ABRA Flexi — accounting, contacts, stock and draft-checked invoice creation.
Connect Exact Online to your AI assistant via MCP. Manage Exact Online with natural language.
Invoicing you drive by talking to your AI: log time, raise invoices and track what's owed via MCP.
Fakturownia.pl (Polish invoicing) via MCP: invoices, clients, products, warehouse. Full read-write.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server to interact with the Cuéntica accounting API, allowing users to manage invoices, expenses, income, clients, providers, and bank accounts via natural language.5931 PyPI2MIT
- AlicenseBqualityBmaintenanceEnables natural language interaction with the WeFact invoicing platform, allowing users to manage debtors, invoices, products, subscriptions, and perform various administrative tasks via MCP-compatible clients.1821 PyPI1AGPL 3.0
- AlicenseAqualityBmaintenanceMCP server for the Elorus invoicing and accounting platform, enabling AI assistants to create invoices, manage contacts, and query financial data through natural language.435MIT
- AlicenseNot gradedqualityDmaintenanceModel Context Protocol (MCP) server for SuperFaktura invoicing system. Enables AI assistants to interact with SuperFaktura API for managing invoices, clients, and expenses.Apache 2.0