# @whiteintel/mcp-server
**They trace names. We trace who really owns them.**
[](https://replit.com/integrations?mcp=eyJkaXNwbGF5TmFtZSI6IldoaXRlSW50ZWwiLCJiYXNlVXJsIjoiaHR0cHM6Ly93aGl0ZWludGVsLmRldi9hcGkvbWNwIn0%3D)
The corporate-ownership & sanctions intelligence layer for AI agents β built for the agentic era. WhiteIntel turns public-registry and offshore-leak data into MCP-native intelligence primitives β **entity search, semantic discovery, ownership-path traversal, sanctions screening, offshore-exposure detection, and fully cited dossiers** β so any AI agent can investigate a company, trace its ultimate beneficial owner, and flag risk in one conversation. Your agent isn't querying a database β it's conducting an investigation.
**[Read the Methodology β](https://whiteintel.dev/methodology)**
[](https://www.npmjs.com/package/@whiteintel/mcp-server)
[](https://github.com/Hei33enberg/whiteintel-mcp-server/actions/workflows/ci.yml)
[](LICENSE)
[](https://modelcontextprotocol.io)
[](https://whiteintel.dev/developers)
[](https://whiteintel.dev/coverage)
[](https://whiteintel.dev/sources)
[](https://whiteintel.dev)
---
## What's live today
**One command, any MCP agent:**
```bash
npx -y @whiteintel/mcp-server
```
β¦starts an MCP server with **24 tools** that give any AI agent β Claude Desktop, Cursor, Cline, Windsurf, or your own runtime β **full corporate-ownership intelligence**: search by name or meaning, trace ownership chains to the UBO, screen sanctions across OFAC/EU/UN/UK, detect offshore layering, pull fully cited dossiers with financials and asset layers, and even purchase deeper intelligence through agent-initiated Stripe checkout. Every claim cited to its source, every edge traced to a registry record.
| Tool | What it does | Category |
|---|---|---|
| `search_entities` | Search the corpus (companies + people) by name β entity ids | π Discovery |
| `semantic_search` | Meaning-based search (BGE-M3 vector ANN) β find entities by profile, not keywords | π Discovery |
| `find_similar` | "More like this" β nearest entities to a known id, for peer discovery and clustering | π Discovery |
| `search_companies` | Free-text company-name search β registration number | π Discovery |
| `lookup_company` | UK company by Companies House number β record + ownership graph | π Lookup |
| `lookup_by_identifier` | Resolve by strong id β LEI, OFAC/EU/UN/UK sanctions id, UEN, SEC CIK, KRS, GB-COH, SIREN, Brazil RFB CNPJ | π Lookup |
| `get_entity` | Full record for one entity + its direct relationships | π Lookup |
| `resolve` | Batch-resolve names or `scheme:value` ids β canonical entity ids + confidence | π Lookup |
| `list_jurisdictions` | Coverage map per country β tier, scope and record depth we hold | πΊοΈ Coverage |
| `list_asset_coverage` | Coverage map per asset class β aircraft, vessels, real estate | πΊοΈ Coverage |
| `get_dossier` | Structured, fully-cited dossier: identity, ownership/UBO chain, risk, provenance | π Intelligence |
| `trace_ownership_path` | Walk ownership upward to the ultimate beneficial owner | π Intelligence |
| `graph_neighbourhood` | Every edge within N hops of an entity, both directions β hard-capped, says when the view is partial | πΈοΈ Graph |
| `graph_path` | How two entities are connected β **bounded, not exhaustive**: `found: false` is not proof of no link | πΈοΈ Graph |
| `get_sanctions` | Sanctions exposure (OFAC/EU/UN/UK) for entity and its resolved cluster siblings | π‘οΈ Risk |
| `check_offshore_exposure` | Flag sanctioned + secrecy-jurisdiction hops in the ownership chain | π‘οΈ Risk |
| `get_company_details` | UK register detail: address, status, SIC, filings, charges, former names | π Lookup |
| `get_financials` | Filed UK financials YoY (turnover, profit, net assets, cash, employees) | π Intelligence |
| `get_pulse` | Live corpus activity feed β recent ownership/control changes, sourced | π Intelligence |
| `get_pricing` | Full price list + machine-readable purchase flow (static, no network call) | π³ Commerce |
| `buy_dossier` | Start a one-off dossier purchase via guest Stripe Checkout β `checkout_url` | π³ Commerce |
| `get_payment_link` | Permanent, reusable Stripe payment links β the artefact you hand to a human | π³ Commerce |
| `claim_dossier` | Redeem a paid session for a 90-day access token (idempotent) | π³ Commerce |
**24 callable tools** β 4 Discovery + 4 Lookup + 2 Coverage + 4 Intelligence + 2 Graph + 2 Risk + 4 Commerce + 1 Feed + 1 Pricing. All read-only except `buy_dossier` (opens Stripe β money moves only when a human completes it) and `claim_dossier` (redeems an already-paid session). Ids flow between tools: search β get_dossier β trace_ownership_path β get_sanctions.
## Quickstart (60 seconds)
> **Distribution:** the package is on npm β `npx -y @whiteintel/mcp-server` Just Works.
**1. Run it.** No key needed β works anonymously on the free tier:
```bash
npx -y @whiteintel/mcp-server
```
**2a. Claude Desktop / Cursor** β add to your MCP config:
```json
{
"mcpServers": {
"whiteintel": {
"command": "npx",
"args": ["-y", "@whiteintel/mcp-server"],
"env": { "WHITEINTEL_API_KEY": "wi_β¦" }
}
}
}
```
**2b. Claude Code CLI:**
```bash
claude mcp add whiteintel -- npx -y @whiteintel/mcp-server
```
**2c. One-click:** add WhiteIntel to your editor at **[whiteintel.dev/developers](https://whiteintel.dev/developers)**.
The `env` block is optional β omit it to use the anonymous free tier. Set `WHITEINTEL_API_KEY=wi_β¦` to authenticate as your plan and lift limits.
### Try it
> **You:** "Who ultimately owns Revolut? Check sanctions on the whole chain."
>
> **Agent:** calls `search_entities({ query: "Revolut" })` β `trace_ownership_path({ id })` β `get_sanctions({ id })` for each hop β a fully cited ownership chain with sanctions screening at every level. Done.
> **You:** "Find companies similar to Wirecard and check for offshore exposure."
>
> **Agent:** calls `find_similar({ entity_id })` β `check_offshore_exposure({ id })` β flagged secrecy-jurisdiction hops and sanctioned intermediaries across the peer set.
## Agents can pay
An agent can buy the paid depth of a dossier end-to-end, **no WhiteIntel account needed:**
1. **`buy_dossier`** `{ tier: "standard" | "premium", entity_id }` β returns a Stripe `checkout_url`. Standard (β¬39) unlocks the full multi-hop UBO chain + financials; Premium (β¬99) adds aircraft, sanctioned vessels and property; on HIGH-risk or sanctioned subjects it additionally runs a live adverse-media scan (that scan is gated β it does not run on lower-risk entities).
2. A **human completes payment** at the `checkout_url` β Stripe collects an email and redirects back.
3. **`claim_dossier`** `{ session_id }` β `{ token, entity_id, tier }`. Idempotent; returns `402` until paid.
4. **`get_dossier`** `{ id, token }` β the unlocked, fully-cited dossier JSON. Tokens valid 90 days.
**No human at the keyboard right now?** Step 1 is the wrong tool: a `checkout_url` is single-use and expires in 24 hours, so it is dead by the time someone reads your report. Call **`get_payment_link`** instead β it returns permanent Stripe links you can paste into a document, a ticket or a message, and append `?client_reference_id=
# @whiteintel/mcp-server
**They trace names. We trace who really owns them.**
