# iGregulator

> Verify gambling operator licenses before they cost you. iGregulator is a daily-refreshed REST API + MCP server for verifying iGaming operator licences against the public registers of the UK Gambling Commission (UKGC), Malta Gaming Authority (MGA), Curaçao Gaming Authority (CGA, post-LOK), Kahnawake Gaming Commission (KGC), Anjouan Gaming Authority (AGA), and Tobique Gaming Commission (TGC). Updated within 24 hours of regulator changes. Built for compliance/AML teams, payment providers, affiliate networks, and investment-intelligence desks that need machine-readable licensing data without enterprise-grade contracts.

6 active jurisdictions today with ~6,570 licences and ~254 regulatory actions ingested. Public endpoints (no key) capped at 10 req/IP/hour. Authenticated tiers unlock higher quotas, per-operator detail, and regulatory-action history. See [rate limits](https://igregulator.io/docs/rate-limits/) for the full tier table.

## MCP server (for AI agents)

Live at **`https://mcp.igregulator.io/mcp`** — streamable-HTTP transport, bearer-token auth (same API keys as direct HTTP). Seven tools: `check_domain`, `search_operators`, `get_operator`, `list_jurisdictions`, `get_jurisdiction`, `get_license`, `get_license_history`. Compatible with Claude Code, Claude Desktop, Cursor, Windsurf, Cline. Setup walkthrough at <https://igregulator.io/docs/mcp/>. Discovery manifest at <https://mcp.igregulator.io/.well-known/mcp.json>.

## Docs

- [Introduction](https://igregulator.io/docs/): What iGregulator does, who it's for, live data-coverage stats.
- [Getting started](https://igregulator.io/docs/getting-started/): First curl call in under a minute — no API key required.
- [Authentication](https://igregulator.io/docs/authentication/): Bearer-token flow, creating and rotating keys.
- [Rate limits](https://igregulator.io/docs/rate-limits/): Public per-IP cap, authenticated per-plan quotas, 429 handling.
- [Endpoints](https://igregulator.io/docs/endpoints/): Map of every route, public vs authenticated split.
- [Confidence scoring](https://igregulator.io/docs/confidence/): How `/v1/check` assigns `high | medium | low` and when it refuses to guess.
- [Pagination](https://igregulator.io/docs/pagination/): `limit`/`offset` semantics and cursor-vs-offset rationale.
- [Error handling](https://igregulator.io/docs/errors/): Error-code reference and retry strategy.
- [Code examples](https://igregulator.io/docs/code-examples/): curl, JavaScript (fetch), Python (requests) snippets.
- [Webhooks](https://igregulator.io/docs/webhooks/): Push alerts on licence changes, expiries, regulatory actions. HMAC signing, 7-attempt jittered retry, multi-secret rotation with 7-day overlap. Ten event types.
- [Webhooks quickstart](https://igregulator.io/docs/webhooks/quickstart/): Two-minute setup via webhook.site — no server required.
- [Watchlist](https://igregulator.io/docs/watchlist/): Track specific operators for automated alerts. Webhooks primary, polling fallback via `/v1/watchlist/events`. Plan limits per tier.
- [For AI agents](https://igregulator.io/docs/for-ai-agents/): Machine-readable resources (llms.txt, OpenAPI), structured errors, `_meta` provenance, MCP server, integration patterns (merchant KYB, compliance sweeps, reputation scoring).
- [MCP server](https://igregulator.io/docs/mcp/): Live at `mcp.igregulator.io`. Streamable-HTTP transport, 7 tools (check_domain, search_operators, get_operator, list_jurisdictions, get_jurisdiction, get_license, get_license_history). Bearer-token auth — same API keys as direct HTTP. Setup for Claude Desktop, Cursor, Windsurf at /docs/mcp.
- [Changelog](https://igregulator.io/docs/changelog/): Version history, breaking-change policy, deprecation notices.

## API

- [OpenAPI spec (JSON)](https://api.igregulator.io/openapi.json): Machine-readable API schema in OpenAPI 3.1 format. Parse this for request/response schemas, auth requirements, and rate-limit metadata.
- [API reference](https://igregulator.io/docs/api/): Human-readable generated reference, one page per endpoint, tag-grouped.
- [API playground](https://igregulator.io/docs/playground/): Interactive try-it-out against production via Scalar.

## Optional

- [Full docs as markdown](https://igregulator.io/llms-full.txt): Every guide page concatenated into a single file — easier for context-constrained agents to ingest in one fetch.
- [Dashboard](https://app.igregulator.io): Authenticated user surface. Signup lands with Phase 2 billing.
- [Operator detail pages](https://app.igregulator.io/sitemap.xml): Publicly crawlable read-only operator records at `/operators/<slug>` (e.g. `https://app.igregulator.io/operators/elevated-entertainment-ltd`) with schema.org Organization JSON-LD. ~3,700 pages — the linked sitemap enumerates every operator URL.
- [Waitlist](https://igregulator.io/#waitlist): Pre-launch access sign-up.
- [Contact](mailto:founder@igregulator.io): founder@igregulator.io