Skip to main content
Glama
AbraFlexi MCP Server

AbraFlexi MCP Server

AbraFlexi MCP Server

License: MIT Python 3.10+ PyPI version Packaging: deb M8ven Score

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. Call server_info to 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 _context block on every response, together with a note clarifying any counterparty fields on the records (e.g. an invoice's nazFirmy is 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 invoices

  • invoice_issued_update - Update existing issued invoices

  • invoice_issued_delete - Remove issued invoices

  • invoice_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 invoice

  • invoice_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 contacts

  • contact_update - Update existing contacts

  • contact_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 use

  • contact_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 products

  • product_update - Update existing products

  • product_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 evidence

  • evidence_update - Update record in any evidence (supports remove_external_ids)

  • evidence_delete - Delete record from any evidence

  • evidence_list - List all evidences available on the bound company (live evidence-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 respect READ_ONLY)

🔒 Locking, Actions & Batch Operations

  • evidence_lock / evidence_unlock / evidence_lock_for_ucetni - Lock/unlock a record

  • evidence_storno - Cancel (storno) a document record

  • evidence_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 record

  • evidence_list_attachments - List a record's attachments

  • evidence_get_attachment - Get metadata for a single attachment

  • evidence_download_attachment - Download an attachment to a local file

  • evidence_get_attachment_thumbnail - Download an image attachment's thumbnail

  • evidence_delete_attachment - Delete an attachment

🧾 Reports, QR Codes & User Queries

  • evidence_export_report - Export a PDF/XLSX report for a record or evidence listing

  • evidence_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 evidence

  • evidence_get_reports - List the printable reports available for an evidence

  • evidence_get_relations_list - List the sub-evidences (relations) available for an evidence

  • evidence_get_sum - Get summation (totals) for an evidence

  • evidence_get_record_changes - Get a single record's change history

🏷️ Labels (štítky)

  • evidence_get_labels - Get labels assigned to a record

  • evidence_set_label - Add a label

  • evidence_unset_label - Remove specific label(s)

  • evidence_unset_labels - Remove all labels

🔄 Changes API (company-wide incremental sync)

  • changes_enable / changes_disable - Toggle change tracking

  • changes_status - Check whether change tracking is enabled

  • changes_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

webhook_list

List registered hooks of the bound company

read-only

webhook_get

One hook incl. its current failure penalty

read-only

webhook_register

Register a hook (url, format JSON/XML, optional sec_key, last_version, skip_url_test). AbraFlexi sends an empty test call and refuses the hook unless the URL answers 2xx

create (not idempotent, check webhook_list first)

webhook_unregister

Remove a hook

destructive, idempotent

webhook_retry

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

pip install abraflexi-mcp-server

Then run the server:

abraflexi-mcp

Option 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.AppImage

No Python or pip required. See AppImage section for details.

Option 3: Install from Source

  1. Clone the repository:

    git clone https://github.com/VitexSoftware/abraflexi-mcp-server.git
    cd abraflexi-mcp-server
  2. Install with uv (recommended):

    uv sync
    uv run python scripts/start_server.py

    Or 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 details

Configuration

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 username

  • ABRAFLEXI_PASSWORD - Your AbraFlexi password

Method 2: Session ID

  • ABRAFLEXI_AUTHSESSID - Your AbraFlexi session ID

Optional Configuration

  • READ_ONLY - Set to true, 1, or yes to enable read-only mode (default: true)

  • ABRAFLEXI_WEBHOOK_ALLOWED_HOSTS - Optional comma-separated allowlist of host names webhook_register may 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) or streamable-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 to no-auth for streamable-http transport

Usage

Running the Server

With startup script (recommended):

uv run python scripts/start_server.py

Direct execution:

uv run python -m abraflexi_mcp_server.server

CLI help:

abraflexi-mcp --help

Transport 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=stdio

HTTP 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-auth

Testing

Run test suite:

uv run python scripts/test_server.py

Read-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-server

With an env file:

podman run --rm -p 8000:8000 --env-file .env abraflexi-mcp-server

Container environment defaults

Variable

Default

ABRAFLEXI_MCP_TRANSPORT

streamable-http

ABRAFLEXI_MCP_HOST

0.0.0.0

ABRAFLEXI_MCP_PORT

8000

READ_ONLY

true

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.sh

The script downloads a portable CPython and appimagetool automatically. The resulting file is placed in build/appimage/:

build/appimage/AbraFlexi-MCP-Server-<version>-x86_64.AppImage

Running 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.AppImage

With 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.AppImage

Development

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 file

Running 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.json

Exit 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 .env file (never commit to git)

  • 🔒 Enable read-only mode for monitoring-only use cases

  • 🛡️ Use HTTPS for AbraFlexi server connections

  • 🔄 Regularly rotate passwords

  • 📁 Ensure .env file has proper permissions (600)

Troubleshooting

Common Issues

Connection Failed:

  • Verify ABRAFLEXI_URL is correct and accessible

  • Check 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 sync

  • Verify Python version compatibility (3.10+)

Debug Mode

Set environment variable for detailed logging:

export DEBUG=1
uv run python scripts/start_server.py

Dependencies

License

This project is licensed under the MIT License.

Acknowledgments

Support

Author

Vítězslav Dvořák


Made with ❤️ for the AbraFlexi and MCP communities

Available Tools

68 tools
abraflexi_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_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_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

    B3.2/5.0

    Scored across 68 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP server to interact with the Cuéntica accounting API, allowing users to manage invoices, expenses, income, clients, providers, and bank accounts via natural language.
      59
      31 PyPI
      2
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      18
      21 PyPI
      1
      AGPL 3.0
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for the Elorus invoicing and accounting platform, enabling AI assistants to create invoices, manage contacts, and query financial data through natural language.
      43
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Model 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