@igamingfinder/cli

The command-line tool and MCP server for iGaming Finder. Look up iGaming companies, gambling licenses and casino domains. Follow changes on official gambling registers, find decision-maker contacts, and download your prospect lists. Use it in a terminal or a script, or connect it to an AI assistant such as Claude or Cursor, so that the assistant can run the same lookups for you.

Install

You need Node.js 18 or later.

npm install -g @igamingfinder/cli
igamingfinder --help

To run it without installing:

npx -y @igamingfinder/cli --help

Get an API key

1. Run igamingfinder signup. It opens the signup page. New accounts get welcome bonus credits.
2. Click the link in the email that we send you.
3. Copy your API key from igamingfinder.com/account/api-keys.
4. Save the key. The CLI asks for it and hides what you type, so the key stays out of shell history:

igamingfinder config set-key
igamingfinder account

The CLI saves the key in ~/.config/igamingfinder/config.json, readable only by you. IGAMINGFINDER_API_KEY in your environment takes priority over the saved key; for an MCP client, put it in the client's environment settings (see below). igamingfinder config show displays only the first eight characters of the key and the API URL. Do not pass the key as an argument: config set-key <key> and the --token flag can leave it in shell history, and --token can show it in process lists. Do not share your config file or a real key in screenshots.

Credits

• Previews, account, logos search, people roles and prospect lists are free.
• Each paid command says in its --help how it is billed: per result, per profile, per contact, per verdict, per row or per Signal.
• Every paid response includes credits_charged.
• Every paid command accepts --max-credits <n>. The call is refused if it would cost more than that.
• Run igamingfinder account to see your plan and credit balance.

Use it with an AI assistant (MCP)

Hosted server

Add this URL as a custom connector in Claude, Cursor, Codex or any MCP client that supports remote servers:

https://mcp.igamingfinder.com/mcp

Your client opens iGaming Finder sign-in in the browser. Sign in, choose how many credits the assistant may spend, and approve. You do not need Node.js or an API key. Setup for each client: igamingfinder.com/docs/mcp.

Local server

To run the server on your own machine, add this to the MCP settings of Claude Desktop (claude_desktop_config.json) or Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "igaming-finder": {
      "command": "npx",
      "args": ["-y", "@igamingfinder/cli", "mcp"],
      "env": { "IGAMINGFINDER_API_KEY": "client_YOUR_KEY" }
    }
  }
}

Tools

Signals: changes on official gambling registers, billed per Signal. Each Signal has a signal_ref.

• signals_market_entries: operator changes on one market's register.
• signals_register_changes: all changes on one jurisdiction's register.
• signals_platform_sites: operator sites first seen on one platform.

Companies

• companies_search_preview: how many companies match a search, and its cost. Free.
• companies_search: find companies, or with related the organisations related to one company_ref, company page URL or domain. Billed per result.
• companies_resolve: full profile of one company, identified by exactly one of company_ref, domain, page_url (a company page URL, path /company/<slug>), or legal_entity. Search names with companies_search and q, then use a returned identifier. Billed per profile; optional firmographics cost 12 credits per delivered company and return one object or null, while optional people return an array billed per delivered contact. When an identifier names several companies, nothing is charged and next_action gives the search that lists them.
• companies_firmographics: one company firmographics object or null. Billed 12 credits per delivered company.
• companies_people: decision-maker contacts in an array. Billed per delivered contact. total is the number of people the company page lists. It is not the number that match role. It is null when people are unavailable. One call returns one page (10 contacts by default, 100 at most). To get the next page, pass next_cursor as after (--after) and keep the same other arguments; only next_cursor: null means that no contact is left. If a cursor is rejected, nothing is charged; start again without after. deliverable is the number of people of the page the tool can deliver; when it is lower than total, the others are not available.

All three company lookup tools and their CLI commands take exactly one of the four identifiers above; none accepts a positional company identifier. --name is not a lookup option; use companies search --q <name>. The recommended path is companies search, then --page-url. By domain, people and firmographics use the main company page of the domain; each contact names its page. When the main page is not known, the call is refused at zero credits and next_action gives the related search that lists the pages. A domain no company page names, a shared platform domain, or a too-broad domain returns 404 at zero credits. The standalone endpoints are GET /v1/companies/firmographics and GET /v1/companies/people.

Licenses

• licenses_search_preview: how many licenses match a search, and its cost. Free.
• licenses_search: find licenses. Billed per result.
• licenses_resolve: full license profile. Billed per profile.

Domains

• domains_resolve: is a casino domain licensed or blocklisted, and by whom. Billed per verdict; only the Operator Launch Profile and data refreshes add a charge.
• domains_search: all domains with one verdict, such as a country's blocklist. Billed per row.

Logos

• logos_search: find a logo by name. Free.

People

• people_roles: the role keys for filtering contacts. Free.

Prospect lists

• prospect_lists_list, prospect_lists_show, prospect_lists_download: read and download your prospect lists. Free.

Account

• account_show: your plan and credit balance. Free.

To get the next page of a list, pass next_cursor from the response as after.

CLI examples

Signals

# Operator changes on the Anjouan register, 5 rows (paid, per Signal)
igamingfinder signals market-entries --role operator --market anjouan --page-size 5

# The next page: pass next_cursor from the previous response (paid, per Signal)
igamingfinder signals market-entries --role operator --market anjouan --page-size 5 --after 'igfcur_...'

# Revocations on the UKGC register (paid, per Signal)
igamingfinder signals register-changes --jurisdiction ukgc --event-type revoked

# Operator sites first seen on the Digitain platform (paid, per Signal)
igamingfinder signals platform-sites --role operator --platform digitain

Companies

# How many MGA-licensed companies match, and what the search costs (free)
igamingfinder companies preview --jurisdiction mga

# MGA-licensed companies, 25 per page, never more than 25 credits (paid, per result)
igamingfinder companies search --jurisdiction mga --page-size 25 --max-credits 25

# Full profile of the company behind stake.com (paid, per profile)
igamingfinder companies resolve --domain stake.com

# Full profile of the company behind a company page URL (paid, per profile)
igamingfinder companies resolve --page-url '<company page URL>'

# Organisations related to stake.com, one row per company page (paid, per result)
igamingfinder companies search --related stake.com --page-size 10 --max-credits 10

# Firmographics for one company (12 credits when delivered)
igamingfinder companies firmographics --company-ref igfc_a1b2c3 --max-credits 12

# How many contacts the company has for each role (free)
igamingfinder companies people --company-ref igfc_a1b2c3 --counts-only

# Decision-makers at the company, never more than 90 credits (paid, per delivered contact)
igamingfinder companies people --company-ref igfc_a1b2c3 --role decision_makers --max-credits 90

# The next page: the command the CLI printed after the page before (paid, per delivered contact)
igamingfinder companies people --company-ref igfc_a1b2c3 --role decision_makers --max-credits 90 --after 'igfcur_...'

# Every CEO of the company page, in as many pages as 900 credits allow
igamingfinder companies people --company-ref igfc_a1b2c3 --role ceo --all --max-credits 900

Licenses

# How many UKGC licenses match, and what the search costs (free)
igamingfinder licenses preview --jurisdiction ukgc

# UKGC licenses, 25 per page (paid, per result)
igamingfinder licenses search --jurisdiction ukgc --page-size 25

# One license by its number (paid, per profile)
igamingfinder licenses resolve --license-number MGA/B2C/213/2011 --jurisdiction mga

Domains

# Is roobet.com licensed or blocklisted, and by which regulators? (paid, per verdict)
igamingfinder domains resolve roobet.com

# Verdict and launch profile, with data no older than 7 days (paid, verdict plus profile; can take a few minutes)
igamingfinder domains resolve ncc.bet --include operator_launch_profile --max-age-days 7 --max-credits 6

# The platforms the site has run on (paid, per verdict)
igamingfinder domains resolve winner.ro --include platform_history

# The Polish blocklist, for payment screening (paid, per row)
igamingfinder domains search --verdict blocklisted --geo pl

# Domains blocklisted since 1 June 2026 (paid, per row)
igamingfinder domains search --verdict blocklisted --since 2026-06-01

Logos and people roles

# Find a payment-method logo (free)
igamingfinder logos search skrill --kind payment_method

# The role keys for 'companies people --role' (free)
igamingfinder people roles

Prospect lists

# Your ready prospect lists (free)
igamingfinder prospect-lists list --status ready

# One prospect list as JSON (free)
igamingfinder prospect-lists show igfpl_a1b2c3

# One prospect list as a CSV file (free)
igamingfinder prospect-lists download igfpl_a1b2c3 -o prospect-list.csv

Account

# Your plan and credit balance (free)
igamingfinder account

JSON and jq

Data commands print JSON when their output goes to a pipe or a file. Commands that print a table in the terminal also accept --json. This lets you use jq:

igamingfinder signals market-entries --role operator --market anjouan \
  | jq -r '.signals[] | [.signal_ref, .subject.published_legal_name, .change.event_type] | @tsv'
igamingfinder companies search --jurisdiction mga --json | jq -r '.hits[] | .primary_domain.domain // empty'

Shell completion

Generate a completion script for your shell. It completes command, subcommand and option names:

igamingfinder completion fish > ~/.config/fish/completions/igamingfinder.fish
igamingfinder completion zsh  > "${fpath[1]}/_igamingfinder"   # then run: compinit
igamingfinder completion bash > ~/.local/share/bash-completion/completions/igamingfinder

Help and docs

• Run igamingfinder <command> --help for all options and examples of a command.
• CLI guide: igamingfinder.com/docs/cli
• MCP setup: igamingfinder.com/docs/mcp
• API reference: igamingfinder.com/docs/api

License

Licensed under the Elastic License 2.0 — see LICENSE. Bundled third-party components are listed in THIRD_PARTY_NOTICES.md.