Skip to main content
Glama
Sign In
deenesjakoruzh
uol-mcp-http

uol-mcp-http

by ondrejsanetrnik
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

uol-mcp-http

HTTP MCP server for the UOL Accounting REST API (Streamable HTTP for Railway and Cursor).

Reads run immediately. POST / PATCH / PUT / DELETE go through uol_request and need confirm=true.

Env

  • UOL_API_BASE_URL — tenant API root, e.g. https://YOUR-TENANT.ucetnictvi.uol.cz/api (with or without /v1)

  • UOL_API_EMAIL — UOL login email (Basic Auth username)

  • UOL_API_TOKEN — token from UOL Settings → /api_tokens

  • MCP_AUTH_TOKEN — Bearer token required by MCP clients

  • PORT — listen port (Railway sets this)

Demo (OpenAPI): https://test.demo.uol.cz/api + the demo email/token from https://api.uol.cz/

Related MCP server: accounting-mcp

Endpoints

  • GET /health — healthcheck

  • POST /mcp — MCP Streamable HTTP (auth required)

Cursor

Do not commit real tokens. Add this locally in .cursor/mcp.json:

{
  "mcpServers": {
    "uol": {
      "url": "https://uol-mcp-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_AUTH_TOKEN"
      }
    }
  }
}

YOUR_MCP_AUTH_TOKEN is MCP_AUTH_TOKEN in local .deploy-secrets (gitignored) and on the Railway service.

This instance currently talks to the UOL demo tenant (https://test.demo.uol.cz/api). For live Gramodesky accounting, change Railway vars UOL_API_BASE_URL / UOL_API_EMAIL / UOL_API_TOKEN to the production tenant (same values as shop UOL_API_*).

GramBot (later)

When the shop worktree is clean, attach HTTP MCP with MCP_UOL_URL + MCP_UOL_TOKEN (same pattern as Daktela / Fio).

Rate limit

UOL returns HTTP 429 for 30 seconds when exceeded: 30 requests / 10 seconds (receivables: 10 / 10 seconds).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    • Airtable MCP by InsightfulPipeA
      com.insightfulpipe

      Hosted Airtable MCP server for Claude, ChatGPT and Cursor, with each action switched per account.

      DatabasesWorkplace & Productivity
      41
      https://airtable.insightfulmcp.com/
    • Bokio MCP Server and API by CotletA
      dev.cotlet

      Bokio MCP server for ChatGPT, Claude and any AI agent: create invoice, send invoice, upload receipt, create journal entry and list unpaid invoices in your own Bokio account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Bokio yourself; Cotlet does not store your password and you need no Bokio API key. About the official Bokio API: Yes, Bokio has a public REST API for invoices, customers, journal entries, uploads and supplier invoices (checked 14 Oct 2026), but it depends on your price plan and on the kind of integration: a private integration token works for one company only, and a tool that serves several companies must be registered as a public integration with OAuth 2.0. Bokio publishes no MCP server of its own. Setup and FAQ: https://cotlet.dev/integrations/bokio-api-mcp-server

      CRMFinancePayments & Billing
      311
      https://cotlet.dev/mcp/v1/bokio
    • Apideck MCPA
      dev.apideck.mcp

      Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server

      Developer Tools
      42
      https://mcp.apideck.dev/mcp
    • MYOB MCP Server and API by CotletB
      dev.cotlet

      MYOB MCP server for ChatGPT, Claude and any AI agent: create invoice, send invoice, record payment, create bill and list overdue invoices in your own MYOB account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to MYOB yourself; Cotlet does not store your password and you need no MYOB API key. About the official MYOB API: Yes, MYOB has a full REST API, the MYOB Business API, for sales invoices, bills, customer and supplier payments and contacts (checked 14 Oct 2026), but it is not open by default: you request access through the API support form, register an app in my.MYOB for a key and secret, and every user grants OAuth consent per company file. MYOB also runs an official connector for Claude and ChatGPT, but it is read-only and in invite-only beta in Australia, so no official MCP server creates or sends an invoice. Setup and FAQ: https://cotlet.dev/integrations/myob-api-mcp-server

      CRMFinancePayments & Billing
      311
      https://cotlet.dev/mcp/v1/myob

    Related MCP Servers

    • FreeAgent MCP Server

      StupidCodeFactory
      A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for the FreeAgent accounting API, enabling LLMs to securely access and manage accounting data including contacts, invoices, bills, bank transactions, and more.
      5 npm
      1
      MIT

    • accounting-mcp

      straycatse
      F
      license
      Not graded
      quality
      D
      maintenance
      Multi-tenant MCP server connecting accounting software to AI assistants via ~87 tools. Supports Bokio (Swedish accounting) with mock mode for development.
      -

    • reai-mcp

      Stener1
      A
      license
      A
      quality
      D
      maintenance
      MCP server for ReAI, the Norwegian cloud accounting system, enabling AI agents to read books, look up accounts and VAT codes, and perform bookkeeping through a curated toolset with safety guardrails.
      12
      MIT

    • HiveDesk

      Akshit1018
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that exposes an in-browser AI ERP (CRM, stock, invoices, HR) with role-aware agents, enabling natural language chat and confirm-before-write actions.
      MIT