PRRO.cloud MCP server
Commit Oct 31, 2026Provides read-only access to fiscal cash registers, shifts, tasks, billing, and webhooks for AI assistants to help debug and integrate fiscal services.
Also known as prro-cloud/prro-mcp, prro-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.4.0
- Last commit
- Oct 31, 2026
- License
- Apache-2.0
What is PRRO.cloud MCP?
PRRO.cloud provides read-only access to fiscal cash registers, shifts, tasks, billing, and webhooks for AI assistants to help debug and integrate fiscal services.
Summary generated from the project's README
About PRRO.cloud MCP server
Developers integrating fiscal services into shops or accounting systems can use PRRO.cloud to debug and build integrations through AI assistants. This server provides read-only access to fiscal cash registers, shifts, tasks, billing, and webhook delivery history. By connecting to clients like Claude Desktop, Claude Code, or Cursor, an assistant can inspect the real-time state of registers and investigate why specific receipts failed or why webhooks were not received.
Users can run the server locally via stdio using a machine token from an environment variable, or connect to a remote server at mcp.prro.cloud/mcp using an Authorization header. The remote setup is convenient as it requires no installation and is subject to a limit of 120 requests per minute. The server is strictly read-only, meaning it cannot register documents, open or close shifts, or modify any settings. It also provides an OpenAPI contract via a resource to help the assistant write accurate integration code.
What you can do with it
- 1Debug fiscal task failuresAsk the assistant to explain why a specific fiscal task failed and what the error description from the tax service was.
- 2Monitor webhook delivery statusRequest a list of failed webhook deliveries from the last day to identify issues with your receiver.
- 3Check cash register statesInquire which cash registers are visible to your token and whether a shift is currently open on them.
- 4Generate integration codeHave the assistant write a Go webhook handler based on the official API contract.
Written from the project's README. Every use case is checked against a quote from it.
How to install PRRO.cloud MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall PRRO.cloud MCP in Claude Code
$ claude mcp add --env 'PRRO_TOKEN=<YOUR_PRRO_TOKEN>' prro-mcp -- docker run -i --rm ghcr.io/prro-cloud/prro-mcp:0.4.0Install PRRO.cloud MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"prro-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/prro-cloud/prro-mcp:0.4.0"
],
"env": {
"PRRO_TOKEN": "<YOUR_PRRO_TOKEN>"
}
}
}
}Install PRRO.cloud MCP in VS Code
.vscode/mcp.json
{
"servers": {
"prro-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/prro-cloud/prro-mcp:0.4.0"
],
"env": {
"PRRO_TOKEN": "<YOUR_PRRO_TOKEN>"
}
}
}
}Install PRRO.cloud MCP in VS Code CLI
$ code --add-mcp '{"name":"prro-mcp","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/prro-cloud/prro-mcp:0.4.0"],"env":{"PRRO_TOKEN":"<YOUR_PRRO_TOKEN>"}}'Install PRRO.cloud MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"prro-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/prro-cloud/prro-mcp:0.4.0"
],
"env": {
"PRRO_TOKEN": "<YOUR_PRRO_TOKEN>"
}
}
}
}Install PRRO.cloud MCP in Codex
$ codex mcp add prro-mcp --env 'PRRO_TOKEN=<YOUR_PRRO_TOKEN>' --env 'PRRO_TOKEN=<YOUR_PRRO_TOKEN>' -- docker run -i --rm ghcr.io/prro-cloud/prro-mcp:0.4.0Install PRRO.cloud MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.prro-mcp] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/prro-cloud/prro-mcp:0.4.0"] [mcp_servers.prro-mcp.env] PRRO_TOKEN = "<YOUR_PRRO_TOKEN>"
Install PRRO.cloud MCP in Gemini CLI
$ gemini mcp add -s user -e 'PRRO_TOKEN=<YOUR_PRRO_TOKEN>' -e 'PRRO_TOKEN=<YOUR_PRRO_TOKEN>' prro-mcp docker -- run -i --rm ghcr.io/prro-cloud/prro-mcp:0.4.0Install PRRO.cloud MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"prro-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/prro-cloud/prro-mcp:0.4.0"
],
"env": {
"PRRO_TOKEN": "<YOUR_PRRO_TOKEN>"
}
}
}
}Configuration
PRRO_TOKENRequiredSecretMachine API token issued in the PRRO.cloud cabinet
PRRO_TOKENRequiredSecretMachine API token issued in the PRRO.cloud cabinet
PRRO_BASE_URLAPI base URL instead of https://api.prro.cloud, for a local or staging API
PRRO_BASE_URLAPI base URL instead of https://api.prro.cloud, for a local or staging API
PRRO_LANGLanguage of API error messages
PRRO_LANGLanguage of API error messages
PRRO_MCP_LOG_LEVELLevel of the server log written to stderr
PRRO_MCP_LOG_LEVELLevel of the server log written to stderr
| Name | Description | |
|---|---|---|
| PRRO_TOKEN | Machine API token issued in the PRRO.cloud cabinet | RequiredSecret |
| PRRO_TOKEN | Machine API token issued in the PRRO.cloud cabinet | RequiredSecret |
| PRRO_BASE_URL | API base URL instead of https://api.prro.cloud, for a local or staging API | |
| PRRO_BASE_URL | API base URL instead of https://api.prro.cloud, for a local or staging API | |
| PRRO_LANG | Language of API error messages | |
| PRRO_LANG | Language of API error messages | |
| PRRO_MCP_LOG_LEVEL | Level of the server log written to stderr | |
| PRRO_MCP_LOG_LEVEL | Level of the server log written to stderr |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableprro-cloud/prro-mcp is public and reachablegithub.com/prro-cloud/prro-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-31github.com/prro-cloud/prro-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubprro-mcp
MCP-сервер для API PRRO.cloud. Дає ІІ-асистентам (Claude Code, Claude Desktop, Cursor та іншим клієнтам Model Context Protocol) доступ до ваших кас, змін, фіскальних завдань, білінгу і вебхуків.
Для кого: розробники, які інтегрують ПРРО в магазин чи облікову систему. Асистент бачить реальний стан кас, завдань і доставок вебхуків і допомагає писати й налагоджувати інтеграцію: чому чек не пройшов, чи відкрита зміна, чи тестова вона, що відповів приймач вебхука.
- Лише читання. Жоден інструмент не реєструє документів у ДПС, не відкриває і не закриває змін, не змінює налаштувань.
- Працює локально через stdio (токен — зі змінної оточення) або як
віддалений сервер
https://mcp.prro.cloud/mcp(токен — у заголовкуAuthorization), нічого не встановлюючи. - Побудований на prro-go і офіційному Go SDK MCP.
- Віддає асистенту контракт API (OpenAPI) — для написання коду інтеграції.
Токен
Випустіть окремий машинний токен для асистента в кабінеті, у розділі токенів:
- обмежте його касами, які асистент має бачити (найкраще — тестовою касою);
- білінг, рахунки і вебхуки читає лише токен з доступом до всіх кас;
- відкликати токен можна в кабінеті за ідентифікатором
jti— його показує інструментwhoami.
Токен — облікові дані: не комітьте конфігурацію MCP-клієнта з ним у репозиторій.
Встановлення
Claude Desktop — завантажте prro-mcp.mcpb з
останнього релізу,
відкрийте його двічі клацнувши і вставте токен у налаштуваннях розширення.
Пакет містить збірки для macOS і Windows.
Готовий бінарник — архів для Linux, macOS або Windows (amd64/arm64) з
релізів; розпакуйте
prro-mcp у каталог із PATH.
Go (потрібен Go 1.27 або новіший):
go install github.com/prro-cloud/prro-mcp/cmd/prro-mcp@latest
Docker:
docker run -i --rm -e PRRO_TOKEN ghcr.io/prro-cloud/prro-mcp
Перевірка: prro-mcp -version.
Віддалений сервер
https://mcp.prro.cloud/mcp — той самий набір інструментів без
встановлення. Токен передається в заголовку Authorization: Bearer кожного
запиту; сервер пересилає його в API PRRO.cloud і ніде не зберігає. Ліміт —
120 запитів на хвилину з одним токеном.
Claude Code:
claude mcp add --transport http prro https://mcp.prro.cloud/mcp \
--header "Authorization: Bearer ваш_токен"
Або в .mcp.json проєкту (токен — з оточення кожного розробника):
{
"mcpServers": {
"prro": {
"type": "http",
"url": "https://mcp.prro.cloud/mcp",
"headers": { "Authorization": "Bearer ${PRRO_TOKEN}" }
}
}
}
Cursor — ~/.cursor/mcp.json або .cursor/mcp.json:
{
"mcpServers": {
"prro": {
"url": "https://mcp.prro.cloud/mcp",
"headers": { "Authorization": "Bearer ${env:PRRO_TOKEN}" }
}
}
}
Веб-конектори claude.ai і ChatGPT, а також Claude Desktop через «Add custom connector» вимагають OAuth, якого сервер не підтримує, — для них лишається локальний сервер.
Налаштування локального сервера
Claude Code
claude mcp add prro --env PRRO_TOKEN=ваш_токен -- prro-mcp
Або для всієї команди — у .mcp.json в корені проєкту; токен кожен бере зі
свого оточення, тож файл можна комітити:
{
"mcpServers": {
"prro": {
"command": "prro-mcp",
"env": { "PRRO_TOKEN": "${PRRO_TOKEN}" }
}
}
}
Claude Desktop
Найпростіше — пакет prro-mcp.mcpb (див. Встановлення).
Вручну — у claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"prro": {
"command": "/повний/шлях/до/prro-mcp",
"env": { "PRRO_TOKEN": "ваш_токен" }
}
}
}
Cursor
~/.cursor/mcp.json (для всіх проєктів) або .cursor/mcp.json у проєкті:
{
"mcpServers": {
"prro": {
"command": "prro-mcp",
"env": { "PRRO_TOKEN": "${env:PRRO_TOKEN}" }
}
}
}
Docker у будь-якому клієнті
{
"mcpServers": {
"prro": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "PRRO_TOKEN", "ghcr.io/prro-cloud/prro-mcp"],
"env": { "PRRO_TOKEN": "ваш_токен" }
}
}
}
Змінні оточення
| Змінна | Призначення |
|---|---|
PRRO_TOKEN |
Машинний токен API. Обов'язкова. |
PRRO_BASE_URL |
Адреса API замість https://api.prro.cloud — для локального стенда. |
PRRO_LANG |
Мова повідомлень про помилки API: uk (типово) або en. |
PRRO_MCP_LOG_LEVEL |
Рівень журналу: debug, info (типово), warn, error. Журнал іде в stderr; на debug видно запити до API. Токен у журнал не потрапляє. |
PRRO_MCP_RATE_LIMIT |
Лише з -http: запитів на хвилину з одним токеном, типово 120; 0 — без ліміту. |
Інструменти
Усі інструменти лише читають і позначені readOnlyHint. Результат —
структуровані дані (structuredContent за вихідною схемою) плюс коротке
текстове зведення. Гроші — рядками, як в API: суми чеків і готівки — у
гривнях, суми білінгу — у копійках.
| Інструмент | Що повертає |
|---|---|
get_version |
Версія сервісу PRRO.cloud, контракту API, prro-mcp і prro-go. |
whoami |
Клієнт, дозволи токена, доступні каси, строк дії. |
get_dps_status |
Режим роботи з ДПС (онлайн/офлайн) і телеметрія детектора. |
list_cash_registers |
Каси, доступні токену: ідентифікатор, фіскальний номер, режим, стан. |
get_cash_register_state |
Стан каси: зміна (зокрема тестова), підсумки зміни, готівка, офлайн-сесія, позначка «потребує уваги». |
get_task |
Фіскальне завдання: стан, результат (фіскальний номер, посилання на чек) або опис збою ДПС. |
get_billing_usage |
Баланс, поріг блокування, кількість і вартість чеків за період. |
list_invoices |
Рахунки за розрахункові періоди. |
list_webhooks |
Вебхуки, їхні підписки і ліміт кількості. |
list_webhook_deliveries |
Історія доставок вебхука з помилками приймача. |
Ресурс prro://openapi.yaml — публічний контракт API (OpenAPI 3.1), з
яким зібрано сервер. Асистент читає його, коли пише код інтеграції.
Свідомо не входять операції, що пишуть: реєстрація чеків, відкриття і закриття змін, заява залишку готівки, керування офлайн-сесіями, зняття позначки уваги, створення, зміна, видалення і повтор вебхуків.
Приклади запитів
- «Які каси бачить мій токен і чи відкрита на них зміна?»
- «Чому завдання
0199…завершилося помилкою і що з цим робити?» - «Покажи невдалі доставки вебхука за останній день і поясни, що не так із моїм приймачем.»
- «Скільки чеків ми пробили у вересні і скільки це коштувало?»
- «Напиши обробник вебхука
task.failedна Go за контрактом API.»
Розробка
make test # тести з -race
make lint # golangci-lint
make build # bin/prro-mcp
make sync-spec # оновити копію контракту з ../prro-go
Тест контракту звіряє інструменти з internal/spec/openapi.yaml: кожна
операція контракту або обслуговується інструментом, або явно виключена —
нова операція в контракті валить тест.
Випуск
- Перенести зміни з
[Unreleased]у розділ версії вCHANGELOG.md. git tag v0.1.0 && git push origin v0.1.0— workflowReleaseзбере архіви, образghcr.io/prro-cloud/prro-mcp, пакетprro-mcp.mcpbіserver.jsonз SHA-256 пакета, додасть їх до релізу, а workflowMCP Registryопублікуєserver.jsonу реєстрі MCP через GitHub OIDC. Повторити публікацію для вже випущеного тега:gh workflow run registry.yml -f tag=v0.1.0.- Покласти
server.jsonіз релізу в корінь репозиторію і закомітити.
Локально без публікації: make snapshot, потім scripts/mcpb.sh 0.0.0.
server.json містить і віддалений сервер (remotes), тож версію з ним
публікувати лише тоді, коли https://mcp.prro.cloud/mcp уже працює.
Розгортання віддаленого сервера
З прапорцем -http сервер слухає Streamable HTTP без сесій: MCP на /mcp,
перевірка живості на /healthz; токен приходить від клієнта, PRRO_TOKEN
у цьому режимі заборонений. Файл Compose, змінні, приклади Caddy і nginx,
вимоги до проксі й безпеки — у deploy/.
Ліцензія
PRRO.cloud MCP questions
How do I add PRRO.cloud MCP to Claude Code?
Run claude mcp add --env 'PRRO_TOKEN=<YOUR_PRRO_TOKEN>' prro-mcp -- docker run -i --rm ghcr.io/prro-cloud/prro-mcp:0.4.0 in your terminal. Add --scope user to make it available in every project.
How do I add PRRO.cloud MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can this server register documents or change settings?
No, the server is strictly read-only. It does not register documents with the tax office, open or close shifts, or change any settings.
What are the rate limits for the remote server?
The remote server has a limit of 120 requests per minute per token.