{
  "markdown": "<div align=\"center\">\n\n<img src=\"https://raw.githubusercontent.com/Hei33enberg/whiteintel-mcp-server/main/logo-mark-512.png\" width=\"132\" alt=\"WhiteIntel\" />\n\n# @whiteintel/mcp-server\n\n**They trace names. We trace who really owns them.**\n\n<!-- Cursor one-click install (anonymous remote endpoint, no key) -->\n<a href=\"https://cursor.com/install-mcp?name=whiteintel&config=eyJ1cmwiOiJodHRwczovL3doaXRlaW50ZWwuZGV2L2FwaS9tY3AifQ%3D%3D\"><picture><source media=\"(prefers-color-scheme: dark)\" srcset=\"https://cursor.com/deeplink/mcp-install-dark.png\"><img alt=\"Add whiteintel MCP server to Cursor\" src=\"https://cursor.com/deeplink/mcp-install-light.png\"></picture></a>\n\n[![Add to Replit](https://replit.com/badge?caption=Add%20WhiteIntel%20to%20Replit)](https://replit.com/integrations?mcp=eyJkaXNwbGF5TmFtZSI6IldoaXRlSW50ZWwiLCJiYXNlVXJsIjoiaHR0cHM6Ly93aGl0ZWludGVsLmRldi9hcGkvbWNwIn0%3D)\n\nThe 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.\n\n**[Read the Methodology →](https://whiteintel.dev/methodology)**\n\n[![npm](https://img.shields.io/npm/v/@whiteintel/mcp-server.svg)](https://www.npmjs.com/package/@whiteintel/mcp-server)\n[![CI](https://github.com/Hei33enberg/whiteintel-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/Hei33enberg/whiteintel-mcp-server/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-2f7d4f.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-compatible-7c3aed.svg)](https://modelcontextprotocol.io)\n[![Tools](https://img.shields.io/badge/tools-24%20live-00ff7f)](https://whiteintel.dev/developers)\n[![Corpus](https://img.shields.io/badge/corpus-171.2M%20entities-2f7d4f)](https://whiteintel.dev/coverage)\n[![Sources](https://img.shields.io/badge/sources-41%20fused-2f7d4f)](https://whiteintel.dev/sources)\n[![whiteintel.dev](https://img.shields.io/badge/site-whiteintel.dev-5af082)](https://whiteintel.dev)\n\n</div>\n\n---\n\n## What's live today\n\n**One command, any MCP agent:**\n\n```bash\nnpx -y @whiteintel/mcp-server\n```\n\n…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.\n\n| Tool | What it does | Category |\n|---|---|---|\n| `search_entities` | Search the corpus (companies + people) by name → entity ids | 🔍 Discovery |\n| `semantic_search` | Meaning-based search (BGE-M3 vector ANN) — find entities by profile, not keywords | 🔍 Discovery |\n| `find_similar` | \"More like this\" — nearest entities to a known id, for peer discovery and clustering | 🔍 Discovery |\n| `search_companies` | Free-text company-name search → registration number | 🔍 Discovery |\n| `lookup_company` | UK company by Companies House number → record + ownership graph | 📋 Lookup |\n| `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 |\n| `get_entity` | Full record for one entity + its direct relationships | 📋 Lookup |\n| `resolve` | Batch-resolve names or `scheme:value` ids → canonical entity ids + confidence | 📋 Lookup |\n| `list_jurisdictions` | Coverage map per country — tier, scope and record depth we hold | 🗺️ Coverage |\n| `list_asset_coverage` | Coverage map per asset class — aircraft, vessels, real estate | 🗺️ Coverage |\n| `get_dossier` | Structured, fully-cited dossier: identity, ownership/UBO chain, risk, provenance | 📊 Intelligence |\n| `trace_ownership_path` | Walk ownership upward to the ultimate beneficial owner | 📊 Intelligence |\n| `graph_neighbourhood` | Every edge within N hops of an entity, both directions — hard-capped, says when the view is partial | 🕸️ Graph |\n| `graph_path` | How two entities are connected — **bounded, not exhaustive**: `found: false` is not proof of no link | 🕸️ Graph |\n| `get_sanctions` | Sanctions exposure (OFAC/EU/UN/UK) for entity and its resolved cluster siblings | 🛡️ Risk |\n| `check_offshore_exposure` | Flag sanctioned + secrecy-jurisdiction hops in the ownership chain | 🛡️ Risk |\n| `get_company_details` | UK register detail: address, status, SIC, filings, charges, former names | 📋 Lookup |\n| `get_financials` | Filed UK financials YoY (turnover, profit, net assets, cash, employees) | 📊 Intelligence |\n| `get_pulse` | Live corpus activity feed — recent ownership/control changes, sourced | 📊 Intelligence |\n| `get_pricing` | Full price list + machine-readable purchase flow (static, no network call) | 💳 Commerce |\n| `buy_dossier` | Start a one-off dossier purchase via guest Stripe Checkout → `checkout_url` | 💳 Commerce |\n| `get_payment_link` | Permanent, reusable Stripe payment links — the artefact you hand to a human | 💳 Commerce |\n| `claim_dossier` | Redeem a paid session for a 90-day access token (idempotent) | 💳 Commerce |\n\n**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.\n\n## Quickstart (60 seconds)\n\n> **Distribution:** the package is on npm — `npx -y @whiteintel/mcp-server` Just Works.\n\n**1. Run it.** No key needed — works anonymously on the free tier:\n\n```bash\nnpx -y @whiteintel/mcp-server\n```\n\n**2a. Claude Desktop / Cursor** — add to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"whiteintel\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@whiteintel/mcp-server\"],\n      \"env\": { \"WHITEINTEL_API_KEY\": \"wi_…\" }\n    }\n  }\n}\n```\n\n**2b. Claude Code CLI:**\n\n```bash\nclaude mcp add whiteintel -- npx -y @whiteintel/mcp-server\n```\n\n**2c. One-click:** add WhiteIntel to your editor at **[whiteintel.dev/developers](https://whiteintel.dev/developers)**.\n\nThe `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.\n\n### Try it\n\n> **You:** \"Who ultimately owns Revolut? Check sanctions on the whole chain.\"\n>\n> **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.\n\n> **You:** \"Find companies similar to Wirecard and check for offshore exposure.\"\n>\n> **Agent:** calls `find_similar({ entity_id })` → `check_offshore_exposure({ id })` → flagged secrecy-jurisdiction hops and sanctioned intermediaries across the peer set.\n\n## Agents can pay\n\nAn agent can buy the paid depth of a dossier end-to-end, **no WhiteIntel account needed:**\n\n1. **`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).\n2. A **human completes payment** at the `checkout_url` — Stripe collects an email and redirects back.\n3. **`claim_dossier`** `{ session_id }` → `{ token, entity_id, tier }`. Idempotent; returns `402` until paid.\n4. **`get_dossier`** `{ id, token }` → the unlocked, fully-cited dossier JSON. Tokens valid 90 days.\n\n**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=<entity uuid>` to bind one to a specific company. Measured 2026-08-11: those links cover the **Standard** tier only (single / 5 / 25); Premium still goes through `buy_dossier`.\n\nCheck **`get_pricing`** first — it returns the full price list plus this flow in machine-readable form.\n\n## The corpus\n\n**~171.2M entities across 41 fused registries** — every claim cited, every edge traced.\n\n*Measured 2026-08-23 from [whiteintel.dev/api/public/stats](https://whiteintel.dev/api/public/stats) (`entities` = 171,207,760, itself a planner estimate). That endpoint rebuilds its source map by counting registries, so it is always the authority — and a new source shows up there without anyone editing this file.*\n\n| Source | What | Coverage |\n|---|---|---|\n| **OpenOwnership** | UK PSCs (Persons with Significant Control) | 🇬🇧 Full |\n| **GLEIF** | Global LEI registry + parent/child ownership relations — nightly refresh scheduled | 🌍 Global |\n| **ACRA Singapore** | Singapore company registry | 🇸🇬 Full |\n| **ICIJ Offshore Leaks** | Panama Papers, Paradise Papers, Pandora Papers | 🌍 Offshore |\n| **SEC EDGAR** | US securities filings + beneficial ownership | 🇺🇸 Full |\n| **UK Companies House** | Full UK register — bulk + live filing stream | 🇬🇧 Full |\n| **FAA** | US aircraft registry (tail numbers → owners) | 🇺🇸 Full |\n| **France SIRENE** | French company register | 🇫🇷 Full |\n| **Brazil RFB** | Brazilian federal revenue — CNPJ register | 🇧🇷 Full |\n| **Cyprus DRCOR** | Cypriot register — **officers only** (see scope note below) | 🇨🇾 Loading |\n| **OFAC / EU / UN / UK** | Consolidated sanctions lists | 🌍 Live |\n| **+ 26 more** | registries, sanctions lists & UBO registers | 🌍 Growing |\n\n### Cyprus — what it is, and what it is not\n\nCyprus went to production on **2026-08-11** and is **still loading** — so we quote no frozen row count here; ask [`/api/public/stats`](https://whiteintel.dev/api/public/stats) for the current figure.\n\n**Read this before you sell it as Cyprus ownership coverage — it is not.** The Cypriot open data release covers the **nominal layer only: directors, secretaries and trade-name owners.** It contains **no shareholders and no beneficial owners.** Measured on a sample of the loaded edges, roughly **93% are `Directorship`** (Director, Secretary, Authorised Person, general partner) and the remaining **~7% carry the `Ownership` schema with role `Owner`** — those are trade-name proprietorships, a sole trader registered behind a business name, not shareholding in a company. An earlier version of this paragraph said there was \"not one ownership edge\" in the Cyprus data; that was wrong, and it is corrected here rather than quietly deleted, because a claim about what a source does not contain is exactly the kind of sentence a buyer relies on.\n\nThe practical consequence is unchanged and is the part that matters: a Cypriot **company** will typically answer `trace_ownership_path` and `check_offshore_exposure` with `no_ownership_data`. That verdict means *we hold no ownership edges for this subject*, **not** *this company is cleanly owned*. Do not read the 7% as shareholder coverage — it is not.\n\nCypriot records carry a `cy-reg:` identifier. `lookup_by_identifier` does **not** accept that scheme — reach them with `search_entities` using `juris: \"cy\"`.\n\n> Contains information from the Cyprus Department of Registrar of Companies and Intellectual Property, licensed under CC BY 4.0.\n\n**Semantic search** (`semantic_search` / `find_similar`) runs over resolved dossier cards using BGE-M3 embeddings; coverage grows as the embedding backfill completes. Measured 2026-08-11 from the endpoint's own `coverage` payload: **990,055 of a 47,486,969 universe embedded (2.1%), and that slice is ~99.6% risk-listed and ~97% natural persons** — so today these two tools behave much more like a sanctions/PEP search than a corpus search, and an empty result usually means \"not embedded yet\". Lexical `search_entities` always covers the full corpus; pair it with either of them before drawing a conclusion.\n\n## Why WhiteIntel\n\n> **What's in a name:** White + Intel — **white** as in transparent, open, cited; **intel** as in intelligence, not data. We don't sell raw records — we sell resolution, traversal, and cited delivery.\n\nExisting corporate-ownership tools were built for compliance analysts clicking web forms. WhiteIntel is the intelligence layer for the agentic era — where the investigator might be a person, an autonomous agent, or an AI workflow, and they all need the same cited, traversed, risk-scored intelligence.\n\n- **Cited, not claimed.** Every ownership edge, every sanctions flag, every risk signal is traced to a public-registry record with a real effective date. We don't invent or infer — if a source doesn't say it, we don't.\n- **MCP-native, not another API wrapper.** Semantic intelligence primitives — not REST endpoints shoe-horned into tool definitions. One command, any MCP agent.\n- **Freemium by design.** The public corpus is free to explore — no sign-in, no API key, no paywall on search. You pay only for depth: full UBO chains, asset layers, monitoring, and export.\n- **Agents can pay.** The only MCP server where an agent can investigate a company, decide it needs the paid dossier, buy it via Stripe Checkout, and receive the cited intelligence — end-to-end, no human portal needed.\n- **Honest about gaps.** An absent edge means \"not yet observed\", not \"does not exist\". Investigative **decision-support**, not a legal determination of beneficial ownership.\n- **No lock-in.** MIT license. Your agent, your data, your investigation.\n\n## Data & honesty\n\n- **Live corpus:** ~171.2M entities across 41 fused registries (measured 2026-08-23). Live counts, always authoritative over this file: [whiteintel.dev/api/public/stats](https://whiteintel.dev/api/public/stats).\n- **Sources are not uniformly deep.** A registry in the list means we hold *what that registry publishes* — which for some jurisdictions is the officer layer, not ownership. Cyprus is the clearest case (see the scope note above). Never read presence in the source table as ownership coverage.\n- An absent edge means \"not yet observed\", not \"does not exist\".\n- Investigative **decision-support**, not a legal determination of beneficial ownership.\n- Semantic search coverage grows as the embedding backfill completes — lexical search always covers the full corpus.\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `WHITEINTEL_API_KEY` | _(none)_ | Optional `wi_` key ([whiteintel.dev → Settings → API keys](https://whiteintel.dev/settings)). Authenticates as your plan, lifts free-tier limits. |\n| `WHITEINTEL_API_BASE` | `https://whiteintel.dev` | API origin (SSRF-guarded to whiteintel.dev hosts). |\n| `WHITEINTEL_TIMEOUT_MS` | `30000` | Per-request timeout. |\n\n## Ecosystem\n\nWhiteIntel is part of a growing intelligence platform:\n\n- **[whiteintel.dev](https://whiteintel.dev)** — the web app: search, graph, dossiers, Pulse feed, monitoring\n- **[WhiteIntel API](https://whiteintel.dev/developers)** — REST API with OpenAPI spec, the same endpoints this MCP server calls\n- **[WhiteIntel Pulse](https://whiteintel.dev/feed)** — live ownership/control change feed across the corporate graph\n- **[@whiteintel/mcp-server](https://www.npmjs.com/package/@whiteintel/mcp-server)** — this package: the MCP intelligence layer\n\n## Who's behind this\n\nWhiteIntel is built and directed by [@Hei33enberg](https://github.com/Hei33enberg) — a self-funded, independent intelligence project. No venture capital, no data brokers, no compromises on citation integrity.\n\n*Swiss governance · Honest by construction*\n\n## Get on the graph\n\n```bash\nnpx -y @whiteintel/mcp-server     # 24 tools, any MCP agent\n```\n\n- **Install** — drop the server into Claude Desktop, Cursor, Cline, Windsurf, or your own runtime (see [Quickstart](#quickstart-60-seconds)).\n- **No key needed** — works on the anonymous free tier out of the box.\n- **Go deeper** — set `WHITEINTEL_API_KEY` for your plan's full depth.\n- **Explore the corpus** — [whiteintel.dev](https://whiteintel.dev) — free to search, no sign-in.\n- **Own it** — [star the repo](https://github.com/Hei33enberg/whiteintel-mcp-server), build on the API, or integrate into your agent pipeline. MIT, no lock-in.\n\n## Contributing\n\nIssues, PRs, and tool ideas welcome. Start with the [CHANGELOG](./CHANGELOG.md) for what's shipped and what's next. If you're building an agent that uses corporate intelligence, we want to hear about it — [intel@whiteintel.dev](mailto:intel@whiteintel.dev).\n\n**Community:** [GitHub Issues](https://github.com/Hei33enberg/whiteintel-mcp-server/issues) for bugs and features, [GitHub Discussions](https://github.com/Hei33enberg/whiteintel-mcp-server/discussions) for design and help.\n\nWeb: [whiteintel.dev](https://whiteintel.dev) · npm: [@whiteintel/mcp-server](https://www.npmjs.com/package/@whiteintel/mcp-server) · Releases: [GitHub](https://github.com/Hei33enberg/whiteintel-mcp-server/releases)\n\n## Privacy Policy\n\nhttps://whiteintel.dev/privacy\n\nThe WhiteIntel MCP server runs locally and calls only `https://whiteintel.dev` (SSRF-guarded).\nIt sends the query terms you pass to a tool and, if set, your `WHITEINTEL_API_KEY`. It does not\nread your files, your conversation history, or your environment beyond `WHITEINTEL_API_KEY`\nand `WHITEINTEL_API_BASE`. Query logs are retained for abuse prevention and are not sold or\nshared with third parties. Contact: hello@whiteintel.dev\n\n## License\n\n[MIT](./LICENSE) © whiteintel.dev\n",
  "bytes": 18032,
  "sha": "7c237d0b186f678f8557810ff0cba68ebb96333a4662879290481ad96703aed8",
  "repo_slug": "hei33enberg/whiteintel-os",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_whiteintel_whiteintel_8113ce6b/readme"
}