gomag-mcp

A production-ready Model Context Protocol (MCP) server for the [Gomag Public API](https://api.gomag.ro), giving AI assistants like Claude direct, audited access to your Gomag e-commerce store.

> Gomag is a Romanian e-commerce platform. This server exposes its entire public REST API as 42 typed MCP tools across 10 categories — from product and order management to shipping (AWB), invoicing, and loyalty points.

---

• 42 MCP tools covering every Gomag Public API endpoint
• Full structured audit logging — every tool call produces an immutable JSON Lines record (file + stderr)
• Sensitive-field redaction — passwords, tokens, and API keys are masked in logs
• Rate-limit awareness — tracks Gomag's Leaky Bucket headers and backs off automatically on 429
• Exponential back-off retry for transient 429 / 5xx failures (configurable retries and factor)
• Connection pooling via httpx.AsyncClient (keep-alive, max connections)
• Fully async — non-blocking from transport to tool handler
• Two MCP resources — gomag://health and gomag://rate-limit for observability
• Zero secrets in code — all credentials come from environment variables

---

• Python ≥ 3.10
• A Gomag store with Public API access enabled
• Your API Key and Shop URL from the Gomag admin panel

---

git clone https://github.com/florinel-chis/gomag-mcp.git
cd gomag-mcp

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

# Install
pip install -e .

pip install gomag-mcp

---

All configuration is via environment variables (prefix GOMAG_). Copy .env.example to .env and fill in your credentials:

cp .env.example .env

| Variable | Description | |--