/ API & MCP

Agent-native corporate intelligence.

Every capability is a tool any AI agent can call — search, ownership paths and full cited dossiers — over a free public REST API and a live MCP server. No auth. No procurement.

REST API docs MCP server

/01

REST API endpoints

Core API reference

Free · no key required

Base URLhttps://whiteintel.dev

/01

Search & resolve

GET/api/public/entity/search

Search the corpus (companies + people) → entity ids.

Param	Where	Req	Description
`q`	query	Yes	Search term (name or identifier).
`type`	query	—	company \| person \| asset.
`juris`	query	—	ISO-2 jurisdiction, e.g. GB.
`risk`	query	—	HIGH \| MED \| LOW.
`limit`	query	—	Default 20, max 50.

Example

curl 'https://whiteintel.dev/api/public/entity/search?q=fortunemaker&type=company'

GET/api/public/semantic-search

Meaning-based (BGE-M3 vector) search — find entities by a natural-language description, no keyword needed. Coverage is partial — the embedded subset is today ~99.6% sanctions/PEP risk-listed (about 97% natural persons); ordinary registry companies are still being embedded. A thin, empty or off-target result means the entity isn't embedded yet, so pair with /api/public/entity/search. Every response carries the live coverage figure.

Param	Where	Req	Description
`q`	query	Yes	Natural-language query.
`k`	query	—	Default 10, max 50.
`kind`	query	—	Company \| Person \| Asset.
`juris`	query	—	ISO jurisdiction, e.g. GB.

Example

curl 'https://whiteintel.dev/api/public/semantic-search?q=sanctioned%20aluminium%20holding'

GET/api/public/similar/{id}

Nearest corpus entities to a given one — 'more like this' for peer discovery. Coverage is partial — only embedded entities return peers, and that subset is today ~99.6% sanctions/PEP risk-listed (about 97% natural persons); ordinary registry companies are still being embedded. Every response carries the live coverage figure.

Param	Where	Req	Description
`id`	path	Yes	Entity id.
`k`	query	—	Default 10, max 50.

GET/api/public/company/search

Free-text UK Companies House company-name search.

Param	Where	Req	Description
`q`	query	Yes	Company name.
`limit`	query	—	Default 8.

GET/api/public/company/{number}

UK company by Companies House number → ownership graph.

Param	Where	Req	Description
`number`	path	Yes	CH registration number — keep leading zeros.

GET/api/public/by-identifier

Resolve an entity by a strong external identifier.

Param	Where	Req	Description
`scheme`	query	Yes	lei \| ofac \| eu \| un \| uk \| uen \| sec \| krs \| gb-coh \| siren \| br-cnpj.
`value`	query	Yes	Identifier value.

POST/api/public/resolve

Batch-resolve a list of names / scheme:value ids → canonical entity ids (max 25 anon / 100 keyed).

Param	Where	Req	Description
`queries`	query	Yes	JSON body { queries: string[] } — names or scheme:value ids.

/02

Dossier & ownership

GET/api/public/entity/{id}

Full record for one entity + its direct relationships.

Param	Where	Req	Description
`id`	path	Yes	Entity id from search.

GET/api/public/dossier/{id}

Structured, fully-cited dossier: identity, ownership/UBO chain, risk, provenance.

Param	Where	Req	Description
`id`	path	Yes	Entity id.

Example

curl https://whiteintel.dev/api/public/dossier/5f6b0655-c36d-55c2-b605-259dcb24a883

GET/api/public/ownership-path

Walk ownership upward to the ultimate beneficial owner(s).

Param	Where	Req	Description
`root`	query	Yes	Root entity id.
`max_depth`	query	—	Default 6, max 10.

/03

Risk & offshore

GET/api/public/sanctions/{id}

Sanctions exposure (OFAC/EU/UN/UK) for an entity + its resolved cluster.

Param	Where	Req	Description
`id`	path	Yes	Entity id.

GET/api/public/offshore-exposure/{id}

Walk the chain; flag sanctioned + secrecy-jurisdiction hops.

Param	Where	Req	Description
`id`	path	Yes	Entity id.
`max_depth`	query	—	Default 6, max 6.

/04

Company data & monitoring

GET/api/public/company-details/{id}

Registered profile: address, status, SIC, incorporation + filing/compliance (overdue, charges, former names).

Param	Where	Req	Description
`id`	path	Yes	Entity id (a UK company).

GET/api/public/financials/{id}

Filed accounts year-over-year — turnover, profit, net assets, cash, employees (Companies House iXBRL).

Param	Where	Req	Description
`id`	path	Yes	Entity id (a UK company).

GET/api/public/pulse

The corpus activity feed — recent ownership and filing events, each cited to a source registry. Poll with since= to stream new events.

Param	Where	Req	Description
`kind`	query	—	ownership \| filing. (Other signal types are reserved for future loaders and would return empty.)
`limit`	query	—	Default 40, max 100.
`since`	query	—	Sync cursor (ISO-8601) — pass the last next_since.

GET/api/public/stats

Live corpus counts — entities, relationships, source registries and high-risk entities.

Prefer machine-readable docs?

openapi.json skills.json

/02

MCP server

MCP landing

18 MCP tools

/01

Search & resolve

resolve

Batch-resolve a whole list of names / scheme:value identifiers → canonical entity ids + confidence, in one call.

search_entities

Search the corpus (companies AND people) by name → entity ids.

semantic_search

Meaning-based (BGE-M3 vector) search over the corpus — find entities by a natural-language description. Coverage is partial — the embedded subset is today ~99.6% sanctions/PEP risk-listed (about 97% natural persons); ordinary registry companies are still being embedded, so pair this with search_entities. Every response carries the live coverage figure.

find_similar

Nearest corpus entities to a given one — 'more like this' for peer discovery and clustering. Coverage is partial — only embedded entities return peers, and that subset is today ~99.6% sanctions/PEP risk-listed (about 97% natural persons); ordinary registry companies are still being embedded. Every response carries the live coverage figure.

search_companies

Free-text company-name search → UK registration number.

lookup_company

UK company by Companies House number → record + ownership graph.

lookup_by_identifier

Resolve by a strong id — LEI, OFAC/EU/UN/UK sanctions id, UEN, SEC CIK, KRS, GB-COH, French SIREN, Brazil RFB CNPJ.

/02

Dossier & ownership

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.

trace_ownership_path

Walk ownership upward from a root entity to the ultimate beneficial owner.

/03

Risk & offshore

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 — the offshore-layering lead.

/04

Company data

get_company_details

UK company register detail: address, status, incorporation, SIC, plus filing/compliance (overdue-flagged).

get_financials

Filed financials year-over-year: turnover, profit, net assets, cash, employees — from Companies House iXBRL accounts.

get_pulse

Recent ownership/control changes across the corpus, newest first, each cited — the live activity feed.

/05

Agent payments

get_pricing

The price list + the exact machine buy-flow — one-off dossiers (€39/€99), packs, subscriptions, metered API. Static, no network.

buy_dossier

Open a guest Stripe Checkout for a one-off cited dossier — no account needed. Returns a checkout_url.

claim_dossier

Redeem the paid Stripe session → an entity-scoped access token, which get_dossier accepts to unlock the report.

Install command

Run the server directly, no install, with npx.

npx -y github:Hei33enberg/WhiteIntel-OS

The npm copy, @whiteintel/mcp-server, is currently behind this one and is missing the graph tools — use the line above until they match.

Claude Desktop config

Add this to your claude_desktop_config.json

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

Environment variables

WHITEINTEL_API_KEYdef: (none)

Optional wi_ key (Settings → API keys). Forwarded as a Bearer token to authenticate as your plan and lift free-tier limits.

WHITEINTEL_API_BASEdef: https://whiteintel.dev

API origin — SSRF-guarded to whiteintel.dev hosts.

WHITEINTEL_TIMEOUT_MSdef: 30000

Per-request timeout.

/03

FAQ

DEVELOPER PLATFORM

WhiteIntel provides an agent-native API and Model Context Protocol (MCP) server that gives developers and AI agents programmatic access to corporate ownership, UBO traversal, sanctions screening, asset layers, and semantic search across 171.2M+ entities.

Yes. Public entity lookups, 1-hop graphs, and basic searches require no API key or sign-in. Setting a 'WHITEINTEL_API_KEY' (wi_…) attributes requests to your account, lifting rate limits and unlocking paid deep UBO traversal and asset layers.

Run 'npx -y github:Hei33enberg/WhiteIntel-OS' or add 'whiteintel' to your client's mcpServers config. This exposes 18 live MCP tools directly to the model with zero boilerplate. The npm copy is currently behind and is missing the graph tools.

The server exposes 18 tools across 5 categories: Discovery (search_entities, semantic_search, find_similar, search_companies), Lookup (lookup_company, lookup_by_identifier, get_entity, resolve, get_company_details), Intelligence (get_dossier, trace_ownership_path, get_financials, get_pulse), Risk (get_sanctions, check_offshore_exposure), and Commerce (get_pricing, buy_dossier, claim_dossier).

An agent calls 'buy_dossier' to generate a guest Stripe checkout URL for a specific entity. A human or delegate completes payment, and the agent calls 'claim_dossier' with the session ID to redeem a 90-day entity dossier token — no account portal management needed.

The 'POST /api/public/semantic-search' endpoint runs BGE-M3 vector similarity over resolved entity cards. This enables natural language queries (e.g. 'offshore maritime logistics firm') returning semantically nearest entities even without exact keyword matches. Note: coverage is partial — the embedded subset is today ~99.6% sanctions/PEP risk-listed (about 97% natural persons); ordinary registry companies are still being embedded. A thin, empty or off-target result means the entity isn't embedded yet, so pair with /api/public/entity/search. Every response carries the live coverage figure.

API quotas use a weighted credit budget per request: 1 credit for point lookups, 2 for detail tables, 3 for graph walks, and 5 for rich cross-source dossiers. This ensures predictable billing without unexpected usage spikes.

No. WhiteIntel provides investigative decision-support and risk scoring with citations for every claim. It does not constitute a formal legal opinion or statutory registry filing.

/ Account

Connect your agent.

The REST API and MCP server work anonymously on the free tier. To lift limits, grab an API key.

Get an API key View pricing limits