@whiteintel/mcp-server

@whiteintel/mcp-server

Trace ownership. Expose the network. A Model Context Protocol server that gives any AI agent (Claude Desktop, Cursor, …) corporate & offshore ownership intelligence from WhiteIntel: look up companies, search entities (companies and people), screen sanctions, and trace ownership chains to the ultimate beneficial owner.

Freemium — works anonymously on the free tier, or set WHITEINTEL_API_KEY to authenticate as your plan and lift the limits (see Configuration). Forwards to WhiteIntel's public REST API (https://whiteintel.dev/api/public/*) — OpenAPI spec.

Install

No install needed — run via npx:

npx -y @whiteintel/mcp-server

Claude Desktop / Cursor

Add to your MCP client config:

{
  "mcpServers": {
    "whiteintel": {
      "command": "npx",
      "args": ["-y", "@whiteintel/mcp-server"],
      "env": { "WHITEINTEL_API_KEY": "wi_…" }
    }
  }
}

The env block is optional — omit it to use the anonymous free tier.

Tools

Tool	What it does
lookup_company	UK company by Companies House number → record + ownership graph (officers, PSCs, parent/subsidiary edges).
search_companies	Free-text company-name search → registration number.
search_entities	Search the corpus (companies + people), live + demo investigations → entity ids.
get_entity	Full record for one entity + its direct relationships.
get_dossier	Structured, fully-cited dossier: cross-source identity, ownership/UBO chain, risk signals, provenance. Optional token (from claim_dossier) unlocks the paid depth.
trace_ownership_path	Walk ownership upward from a root entity to the ultimate beneficial owner.
lookup_by_identifier	Resolve an entity by a strong id — LEI, OFAC/EU/UN/UK sanctions id, UEN, NIP, SEC CIK, KRS, GB-COH.
get_sanctions	An entity's sanctions exposure (OFAC/EU/UN/UK) for it and its resolved cluster siblings, with sources.
check_offshore_exposure	Walk the ownership chain and flag sanctioned + secrecy-jurisdiction hops (offshore-layering lead).
get_company_details	UK register detail: registered address, status, type, incorporation date, SIC codes + the filing/compliance layer (accounts, overdue flags, charges, former names).
get_financials	Filed UK financials year-over-year (turnover, profit, net assets, cash, employees) from Companies House iXBRL accounts.
get_pulse	The live corpus activity feed — recent ownership/control changes, newest first, each sourced; optional since cursor to stream only what's new.
resolve	Batch-resolve a list of names or scheme:value ids → canonical entity ids + confidence, in one call (enrich a whole supplier / portfolio list).
get_pricing	The honest price list (one-off dossiers, packs, subscriptions, metered API) + the exact machine flow for buying access. Static, no network call.
buy_dossier	Start a one-off dossier purchase via guest Stripe Checkout (Standard €39 / Premium €99, optional 5/25 packs) → returns a checkout_url.
claim_dossier	Redeem a paid Checkout session (session_id) for a 90-day entity-scoped access token. Idempotent.

All lookup tools are read-only; the only side-effectful tools are buy_dossier (opens a Stripe Checkout — money moves only when a human completes it) and claim_dossier (redeems an already-paid session). Ids flow between tools: search_entities / search_companies / resolve / lookup_by_identifier return ids → feed them to get_dossier / trace_ownership_path / get_sanctions.

Agents can pay

An agent can buy the paid depth of a dossier end-to-end, no WhiteIntel account needed:

• buy_dossier { tier: "standard" | "premium", entity_id } → returns a Stripe checkout_url. Standard (€39) unlocks the full multi-hop UBO chain + year-over-year financial history; Premium (€99) additionally unlocks itemised assets (vessels, aircraft, securities, real estate). Packs of 5/25 grant reusable report credits.
• A human (or payment-capable agent) completes payment at the checkout_url — Stripe collects an email and redirects back to whiteintel.dev with ?session_id=cs_….
• claim_dossier { session_id } → { token, entity_id, tier }. Idempotent; returns 402 not_paid until payment completes.
• get_dossier { id, token } → the unlocked, fully-cited dossier JSON. Tokens are entity-scoped and valid for 90 days.

Check get_pricing first — it returns the full price list plus this flow in machine-readable form.

Data & honesty

• Live corpus: sanctions (OFAC SDN, EU, UN, UK), GLEIF (LEI), ICIJ Offshore Leaks, SEC EDGAR, OpenOwnership (UK PSC), plus live UK Companies House lookup — cross-source-resolved (a sanctioned party linked to its offshore/registry records).
• Demo: three worked investigations — Meridian (BVI UBO chain), Tideway (sanctions exposure), Ardent (VAT-carousel) — flagged source: "demo".
• An absent edge means "not yet observed", not "does not exist".
• Investigative decision-support, not a legal determination of beneficial ownership.

Configuration

Env var	Default	Purpose
WHITEINTEL_API_KEY	(none)	Optional wi_ key (whiteintel.dev → Settings → API keys). Forwarded as a Bearer token to authenticate as your plan and lift free-tier limits.
WHITEINTEL_API_BASE	https://whiteintel.dev	API origin (SSRF-guarded to whiteintel.dev hosts).
WHITEINTEL_TIMEOUT_MS	30000	Per-request timeout.

License

MIT © whiteintel.dev