# resolve_entity

Canonical cross-source entity resolution - the join-key primitive to run before other combos. Given a company/organization name (plus optional ticker/CIK/EIN/state hints), fans out across the LiveDataLink sources that carry a strong identifier and returns the best-matched canonical identity plus the IDs it resolves to: SEC EDGAR (CIK, ticker), GLEIF (LEI plus the ownership chain - direct and ultimate parent LEI and the reported subsidiary count), NPPES (organizational NPI for healthcare entities), IRS 990 (EIN), USAspending (federal recipient name), EPA ECHO (facility registry id), and an OFAC/EU/UN/BIS sanctions screen (match/no-match flag). Returns a compact canonical-IDs block with per-source confidence, an entity-type guess, an ownership summary, and an overall match confidence - distinct from entity_dossier's full narrative. A source that fails is noted, not fatal. UEI/SAM.gov and RDAP domain-owner ids are omitted (not wired sources). Premium cross-source synthesis; verify identifiers before relying on a join.

Agent View of the PolicyLayer registry record for `resolve_entity`. HTML page: https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/resolve-entity

## Facts

- Tool: `resolve_entity`
- Server: Livedatalink (`https://livedatalink.ai/mcp`) — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink.md
- Homepage: https://github.com/blackboxfoundry/livedatalink
- Risk category: Write (Medium risk)
- Registry record: grade F, identity unverified
- Server auth posture: open
- Server CORS policy: *
- Server rate-limited: no
- Parameters: 5 (1 required)
- Recommended policy verdict: Rate-limited

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `cik` | string | no | Optional SEC CIK hint. |
| `ein` | string | no | Optional EIN for an exact IRS 990 nonprofit match. |
| `name` | string | yes | Company or organization name to resolve (e.g. 'Apple', 'Lockheed Martin', 'Red Cross'). |
| `state` | string | no | Optional 2-letter state to disambiguate nonprofit/EPA name searches. |
| `ticker` | string | no | Optional stock ticker hint to pin the SEC EDGAR match (e.g. 'AAPL'). |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "resolve_entity",
    "arguments": {
      "name": "<name>"
    }
  }
}
```

## Why resolve_entity is rated Medium

An AI agent can call resolve_entity faster than any human can review: one bad instruction and it creates or modifies resources in Livedatalink by the hundred, each call as confident as the last.

## Use case

AI agents use resolve_entity to create or update resources in Livedatalink, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Livedatalink environment.

## Recommended policy (PolicyLayer)

Verdict: **Rate-limited**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Livedatalink:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "resolve_entity": {
      "limits": [
        {
          "counter": "resolve_entity_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}
```

## Other tools on Livedatalink (279)

- `beneficial_owner_screen` — Destructive — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/beneficial-owner-screen.md
- `cdc_dataset_query` — Execute — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-dataset-query.md
- `clinical_site_selector` — Execute — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/clinical-site-selector.md
- `air_quality` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/air-quality.md
- `bank_health_report` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/bank-health-report.md
- `bls_indicator` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/bls-indicator.md
- `bls_series` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/bls-series.md
- `book_details` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/book-details.md
- `book_fulltext_search` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/book-fulltext-search.md
- `book_get_text` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/book-get-text.md
- `book_search` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/book-search.md
- `book_status` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/book-status.md
- `bounce_scanner` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/bounce-scanner.md
- `candlestick_signals` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/candlestick-signals.md
- `cargo_crate` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cargo-crate.md
- `carrier_vetting_score` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/carrier-vetting-score.md
- `caselaw_case_details` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/caselaw-case-details.md
- `caselaw_citation_lookup` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/caselaw-citation-lookup.md
- `caselaw_opinion_text` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/caselaw-opinion-text.md
- `caselaw_search` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/caselaw-search.md
- `cdc_drug_overdose_deaths` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-drug-overdose-deaths.md
- `cdc_excess_deaths_covid` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-excess-deaths-covid.md
- `cdc_flu_surveillance` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-flu-surveillance.md
- `cdc_leading_causes_of_death` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-leading-causes-of-death.md
- `cdc_outbreak_reports` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-outbreak-reports.md
- `cdc_vaccination_coverage` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-vaccination-coverage.md
- `cdc_weekly_deaths_by_state` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/cdc-weekly-deaths-by-state.md
- `census_business` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/census-business.md
- `census_commute_employment` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/census-commute-employment.md
- `census_demographics` — Read — https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink/census-demographics.md
- …and 249 more: https://policylayer.com/tools/io-github-blackboxfoundry-livedatalink.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=io-github-blackboxfoundry-livedatalink · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/io-github-blackboxfoundry-livedatalink
