statusLABSCO SUMMARY
It can start the accounting server for you, and stops only what it started.
Give it the executable path and configuration name and it checks mServer before the first tool call, launching it if needed and shutting it down on exit — but leaving it running if it was already up when the server arrived. Printing needs a report id, which differs per installation; the troubleshooting table also names the usual failure, a 0-byte PDF when mServer can't write to the path you gave.
What it is
A PHP server that talks to the Czech accounting package Pohoda through its mServer XML API: reading documents, stock and the address book, creating invoices, orders, stock cards and contacts, and printing or exporting any record.
What you get
list_documentsacross agendas —invoice,order,voucher,bank,contract,intDoc,offer,enquiry,prijemka,vydejka,prodejka,prevodka,vyroba,accountancy— filtered by id, date range, company, ICO, number or last changelist_stockfiltered by code, name, EAN, storage path or warehouse, andlist_contactsfor the address bookcreate_invoicewith the partner inline or linked from the address book, variable symbol, due date, foreign currency with a rate, and line items tied to stock cardscreate_address,create_stockandcreate_orderfor the other record typesprint— to a printer, to a PDF on the server, or returned as base64 in the responsestatusto check mServer is answering, and withcompanyDetailthe active company, database and accounting yearraw_xmlfor anything the dedicated tools don't cover, plus resources listing the allowed agendas, VAT rates and payment types
Requirements
PHP 8.1+ with ext-curl, ext-dom and ext-simplexml, and a Pohoda installation with mServer enabled on schema version 2. Configure POHODA_URL (default http://localhost:444), POHODA_ICO, POHODA_USERNAME and POHODA_PASSWORD. Setting POHODA_EXE_PATH and POHODA_CONFIG_NAME additionally lets the server start mServer itself — Windows only, since mServer is part of Pohoda.
Setup effort
Build from source — git clone https://github.com/dg/pohoda-mcp.git
USE CASES
01
Finding an invoice and sending it as a PDF
Look the document up by number, then export it to PDF or get it back as base64 in the response.
02
Checking stock before you promise a delivery
Query stock by code, EAN or warehouse instead of clicking through the desktop application.
03
Raising an invoice from the conversation
Create it against an address-book partner with the right variable symbol, due date and stock-linked items.
04
Working out why nothing comes back
Ask for the status with company detail — an empty list usually means mServer is attached to a different company or accounting year.
10 tools
Listed in project docs. Your client may show a different list.
list_documentslist_stocklist_contactscreate_invoicecreate_addresscreate_stockcreate_orderprintraw_xmlBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation.
Requires
- php on PATH
- PHP 8.1+ with ext-curl, ext-dom and ext-simplexml
- composer on PATH
- POHODA_PASSWORD in your environment
- POHODA_URL in your environment
- POHODA_ICO in your environment
- POHODA_USERNAME in your environment
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/dg/pohoda-mcp.git
cd pohoda-mcp
composer installMCP Clients
Claude Code, Any MCP client
JSON
{
"mcpServers": {
"pohoda": {
"command": "php",
"args": [
"<YOUR_PATH_TO_POHODA_MCP>/server.php"
],
"env": {
"POHODA_URL": "http://localhost:444",
"POHODA_ICO": "12345678",
"POHODA_USERNAME": "Admin",
"POHODA_PASSWORD": "",
"POHODA_EXE_PATH": "C:\\Program Files (x86)\\STORMWARE\\POHODA\\Pohoda.exe",
"POHODA_CONFIG_NAME": "mServer1"
}
}
}
}
