MCP Setup

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.ai, Claude Desktop, and Cowork

Add to Claude opens Claude with the connector filled in. Click Continue, then sign in to iGaming Finder when Claude asks.

To add it by hand, open Customize → Connectors, click +, choose Add custom connector, name it iGaming Finder, paste the hosted URL, and click Add. Then sign in to iGaming Finder when Claude asks.

On a Team or Enterprise plan, an owner first adds the connector under Organization settings → Connectors, and each member then clicks Connect under Customize → Connectors. The Free plan allows one custom connector.

Cowork uses the same connector. In a Cowork task, open + → Connectors and turn on iGaming Finder.

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). Set IGAMINGFINDER_API_KEY in the server's environment, or save the key once with igamingfinder config set-key (see CLI). It 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_firmographics`	Firmographics for one company, identified by exactly one of company_ref, domain, page_url or legal_entity.	Paid
`companies_people`	Decision-maker contacts at one company, identified by exactly one of company_ref, domain, page_url or legal_entity.	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_continuation`	Buy the batch of 10 companies that a quote token fixed.	Paid
`companies_search_preview`	Free preview of a company search: how many companies match and what the paid search would cost.	Free
`companies_search_quote`	Quote the next 10 companies of a search that you have not seen or bought for the same query and filters.	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.

companies_resolve takes exactly one identifier: company_ref, domain, page_url (a company page URL with the path /company/<slug>), or legal_entity. Search names with companies_search and q, then use a returned identifier. It returns one company or charges nothing. When an identifier names more than one company, the answer gives the count and the search that lists them. companies_search and companies_search_preview take related to list the organizations related to one company_ref, company page URL, or domain, one row per company page.

companies_firmographics and companies_people accept the same four identifiers as companies_resolve. They do not require a prior profile purchase; even a page-only Company with company_ref: null can be queried with page_url. Ask companies_resolve for include: ["firmographics", "people"] to return both sections inside the one resolved profile, or call either standalone tool. Recommended: companies_search, then page_url. Firmographics is one object or null (12 credits when available); people is an array, billed per contact. By domain, both standalone tools use the main company page of the domain; each contact names its page and, when a company holds the page, that holder's company_ref. When the main page is not known, the call is refused at zero credits with a related search that lists the pages. A domain that no company page names, a confirmed shared platform, or an overly broad domain returns 404 at zero credits. Company paid sections use the page and do not accept freshness controls; Domain resolve still supports its own freshness controls.

companies_people returns one page of contacts per call, 10 by default and 100 at most, and each call is billed for the contacts it returns. To get the next page, pass next_cursor as after and keep the same other arguments. Only next_cursor: null means that no contact is left. With role, the pages together deliver every person of the company page who matches. If a cursor is rejected, nothing is charged; start again without after.

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 company

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"
"Find a Company's page and get its firmographics, within the max_credits budget I give you"
"Resolve this company and include firmographics and people; report the data and the cost of each section"
"Get decision-maker contacts for this company page URL"
"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.