What is MCP?

MCP (Model Context Protocol) lets AI assistants like Claude Desktop, Cursor, and Codex call iGaming Finder tools directly. Ask questions in natural language and get operator intelligence data without writing code.

Hosted setup

Use one endpoint in every client:

text

https://mcp.igamingfinder.com/mcp

You do not need to install Node, copy an API key, set an environment variable, or edit a JSON file. Your client opens iGaming Finder sign-in (OAuth) in your browser. Sign in or create a free account, review the permissions (igf:read to read data, igf:spend to spend credits), choose this app's spending limit, and approve.

You can read these before you sign in:

The tool list only describes the tools. To call them, your client must sign in first. The hosted server and the npm package offer the same tools.

Claude Desktop and Claude.ai

Open Settings → Connectors, add a custom connector, and paste the hosted URL. Claude handles the sign-in steps for you.

Claude Code

bash

claude mcp add --transport http --scope user igaming-finder https://mcp.igamingfinder.com/mcp

Open Claude Code and complete the browser sign-in when the connected app first runs.

Cursor

Open Cursor's MCP settings, add a remote (HTTP) server named igaming-finder, and use the hosted URL. Complete sign-in in the browser; do not add an Authorization header.

Codex

bash

codex mcp add igaming-finder --url https://mcp.igamingfinder.com/mcp
codex mcp login igaming-finder

Session safety

The connected app gets access that you can revoke. It never gets your account API key.
Paid tools need the spend permission and cannot exceed the Spending limit you approve.
A connected app cannot change its own spending limit. The signed-in account owner can set an active app's total limit from Account → AI integrations without reconnecting. The total cannot fall below used plus reserved credits or rise above the account's current credit balance.
account_show reports your account credits and this app's spending limit with its used, reserved, and remaining credits.
When a client disconnects, only that app loses access; your account API key does not change. You can see spending, usage, the app name, its sign-in origins, and disconnect any app from Account → AI integrations. Signing out of the website alone does not disconnect an app.
Free previews are available before a paid call. Paid responses report the actual credits_charged.

$ help --topic=info

You can also run the MCP server on your own machine with the npm package (igamingfinder mcp). It uses the API key saved by the CLI and offers the same tools as hosted MCP. Use hosted sign-in unless you need to run the server yourself.

Available Tools

Once connected, your assistant gets these tools. Paid tools say how they are billed, and every paid response includes credits_charged:

Tool	What it does	Billing
`account_show`	Your plan and credit balance: granted, used, reserved and available.	Free
`companies_people`	Decision-maker contacts at one company.	Paid
`companies_resolve`	Full company profile: licenses, domains, payment methods and content suppliers.	Paid
`companies_search`	Search iGaming companies: operators, game studios, payment providers and affiliates.	Paid
`companies_search_preview`	Free preview of a company search: how many companies match and what the paid search would cost.	Free
`domains_resolve`	Trust verdict for one casino domain: licensed, blocklisted, mixed or no_record, with the regulators that license or block it.	Paid
`domains_search`	All domains with one verdict, filtered by country, date, payment category or platform.	Paid
`licenses_resolve`	Full license profile, found by license_ref or by license number and jurisdiction.	Paid
`licenses_search`	Search gambling licenses from regulators such as MGA, UKGC and Curaçao.	Paid
`licenses_search_preview`	Free preview of a license search: how many licenses match and what the paid search would cost.	Free
`logos_search`	Find a logo by brand, supplier, game or payment-method name.	Free
`people_roles`	The role keys that the `role` filter of companies_people accepts.	Free
`prospect_lists_download`	Download a ready prospect list as CSV.	Free
`prospect_lists_list`	Your prospect lists.	Free
`prospect_lists_show`	One prospect list, with its results once it is ready.	Free
`signals_market_entries`	Operator changes on the official gambling register of one market: operators added to or removed from the register, and changes to status, domains or expiry.	Paid
`signals_platform_sites`	Operator sites we first saw running on one platform, such as Digitain or Altenar.	Paid
`signals_register_changes`	Changes published on one jurisdiction's official gambling register: added, removed, revoked, returned, and changes to domains, expiry, license type, legal entity or status.	Paid

domains_resolve keeps three things apart: the Licensee on the register, the website operator named on the site, and technical links such as shared hosting. A technical link does not show who owns a site.

signals_market_entries lists operator changes on one market's official register, with a signal_ref for each row. The same rows also appear in signals_register_changes. To get the next page, pass next_cursor as after with the same market and date filters. If a cursor is rejected, start again without after.

For companies_resolve, ask for include: ["firmographics"]. Pass a domain_ref to get firmographics for one domain, or leave it out to get them for every eligible domain. Each domain result is billed at the rate below, so set max_credits to the most you want to spend on the profile and all its domains. allow_stale_on_error is true by default; set it to false to get no data instead of older data when a refresh fails.

Request a prospect list with the public request form or the Dashboard form at /prospect-lists/new. Over MCP you can only read prospect lists: prospect_lists_list, prospect_lists_show, and prospect_lists_download are free. CSV is available only when a list is ready, and results stay hidden until then. A prospect list carries only data you can verify: accounts, their organizations, licences and brands, and named contacts. MCP does not send messages.

Cost: 12 credits / delivered Domain result

Example prompts:

"Show operator changes on the Anjouan register with each signal_ref, company name, change type, and source"
"Find MGA-licensed crypto casinos — preview the cost first"
"Resolve stake.com, then get firmographics for its first domain_ref only, within the max_credits budget I give you"
"Resolve this company with firmographics for every eligible domain, keep older data if a refresh fails, and stop if the total would exceed the max_credits budget I give you"
"Resolve stake.com and pull decision-maker contacts"
"Check the trust verdict for roobet.com — which regulators license it, which block it?"
"Resolve ncc.bet with include operator_launch_profile, max_age_days 7, and max_credits 6; report the launch state, legal names on the site, website emails, and the cost breakdown, and do not treat shared hosting as ownership"

Example Conversations

Competitive analysis:

"Show new Anjouan licensees since 2026-01-01, then continue from next_cursor"
"Which operators licensed by MGA feature both Evolution and Pragmatic Play but don't accept crypto?"

Market research:

"List all domains that were blocklisted in the last 7 days"

Due diligence:

"Get the full profile for betway.com, including all licenses and payment methods"

$ help --topic=tip

domains_resolve checks the include names before it calls the API. An available Operator Launch Profile costs 5 credits on top of the 1-credit verdict. If no profile is available, the response says why and there is no extra charge.

Hosted MCP tools use your account credits and stay within the smaller spending limit you approved for this app. Previews and status lookups are free; searches, profiles, contacts, and Signals are billed at the standard rates — see the Credit Costs table in the API reference.