@omnizoek/mcp-server 0.1.3 → 0.1.5

package/README.md

@@ -1,11 +1,11 @@
 # @omnizoek/mcp-server
 
-> **Model Context Protocol server** for OmniZoek — exposes 10 Dutch government data APIs as AI agent tools.
+> **Model Context Protocol server** for OmniZoek — exposes 16 Dutch government data APIs as AI agent tools.
 
-Add this server to Claude Desktop, Cursor, or any MCP-compatible AI client and your agent can instantly look up Dutch addresses, validate IBANs, check vehicle ZE-zone compliance, look up energy labels, and more — all backed by live BAG, EP-Online, RDW, VIES, NS, and ENTSO-E data.
+Add this server to Claude Desktop, Cursor, or any MCP-compatible AI client and your agent can instantly look up Dutch addresses, validate IBANs, geocode locations, look up exchange rates, check company LEI records, check vehicle history, check ZE-zone compliance, look up energy labels, and more — all backed by live BAG, EP-Online, RDW, VIES, NS, ENTSO-E, PDOK, ECB, and GLEIF data.
 
 [![npm version](https://img.shields.io/npm/v/@omnizoek/mcp-server)](https://www.npmjs.com/package/@omnizoek/mcp-server)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE)
 
 ---
 
@@ -23,6 +23,12 @@ Add this server to Claude Desktop, Cursor, or any MCP-compatible AI client and y
 | `omnizoek_grid_trigger` | Get current ENTSO-E electricity price and whether the negative-price trigger is active |
 | `omnizoek_minimum_wage` | Look up the Dutch statutory minimum wage for a given age |
 | `omnizoek_holiday_surcharge` | Check if a date is a Dutch public holiday and get the wage surcharge multiplier |
+| `omnizoek_exchange_rates` | Get the latest ECB daily euro foreign exchange reference rates |
+| `omnizoek_vat_rates` | Get VAT rates for an EU country (full category breakdown for NL) |
+| `omnizoek_geocode` | Forward geocode a free-text query to Dutch coordinates (PDOK Locatieserver) |
+| `omnizoek_reverse_geocode` | Reverse geocode WGS84 coordinates to a Dutch address |
+| `omnizoek_lei_lookup` | Look up a legal entity by LEI code or search by company name (GLEIF) |
+| `omnizoek_vehicle_history` | Full vehicle history from RDW: specs, fuel, APK expiry, open recalls |
 
 ---
 
@@ -120,6 +126,80 @@ Once configured, you can ask your AI agent:
 - *"What is the minimum wage for a 19-year-old in the Netherlands today?"*
 - *"Is 25 December 2025 a public holiday, and what is the retail surcharge multiplier?"*
 - *"What is the current electricity price in the Netherlands, and is the negative-price trigger active?"*
+- *"What are today's euro exchange rates from the ECB?"*
+- *"What are the VAT rates in the Netherlands, broken down by category?"*
+- *"Geocode the address Damrak 1 Amsterdam to coordinates."*
+- *"What address is nearest to coordinates 52.3756, 4.8951?"*
+- *"Look up the LEI record for ING Bank N.V. in the Netherlands."*
+- *"What is the APK expiry date and are there any open recalls for kenteken AB123C?"*
+
+---
+
+## Remote deployment (HTTP / Glama.ai Connector)
+
+The package ships a second entry point — `dist/http.js` — that exposes the same
+16 tools via MCP Streamable HTTP transport. Use this to run OmniZoek MCP as a
+remote server.
+
+### Run locally
+
+```bash
+PORT=3000 OMNIZOEK_API_KEY=omni_live_... npx omnizoek-mcp-http
+# MCP endpoint: POST http://localhost:3000/mcp
+# Health check:  GET http://localhost:3000/health
+```
+
+### Docker (HTTP mode)
+
+```bash
+docker run -p 3000:3000 \
+  -e OMNIZOEK_API_KEY=omni_live_... \
+  -e HTTP_MODE=1 \
+  omnizoek/mcp-server
+```
+
+### Cloud Run (Google Cloud)
+
+```bash
+gcloud run deploy omnizoek-mcp \
+  --image omnizoek/mcp-server \
+  --set-env-vars HTTP_MODE=1 \
+  --port 3000 \
+  --allow-unauthenticated
+
+# Map custom domain (CNAME mcp → ghs.googlehosted.com already set in DNS)
+gcloud run domain-mappings create \
+  --service omnizoek-mcp \
+  --domain mcp.omnizoek.nl \
+  --region europe-west4
+```
+
+The MCP endpoint will be available at `https://mcp.omnizoek.nl/mcp`.
+
+### Authentication
+
+Pass your OmniZoek API key on each request via either header:
+
+```
+Authorization: Bearer omni_live_YOUR_KEY
+X-Api-Key: omni_live_YOUR_KEY
+```
+
+The server requires a key on every request — there is no server-side fallback key.
+This means the deployed endpoint cannot be abused to bill a single account;
+each caller must supply their own key.
+
+> For private/single-tenant deployments you can set `OMNIZOEK_ALLOW_ENV_KEY=1`
+> alongside `OMNIZOEK_API_KEY` to use the env var as a fallback.
+
+### Glama.ai Connector submission
+
+| Field | Value |
+|---|---|
+| Name | OmniZoek |
+| Description | 16 Dutch government data APIs — address enrichment, IBAN→BIC, VAT verify, geocode, vehicle history, energy labels, exchange rates and more. |
+| Server URL | `https://mcp.omnizoek.nl/mcp` |
+| Private Notes | `Authorization: Bearer omni_test_YOUR_KEY` (use a **test key** — never billed) |
 
 ---