`get_entity`

Pack: open-sanctions · Endpoint: https://gateway.pipeworx.io/open-sanctions/mcp

Get full details for a sanctioned entity by its OpenSanctions ID. Returns all properties including names, addresses, identifiers, sanctions programs, and related entities.

Parameters

Name	Type	Required	Description
`id`	string	yes	OpenSanctions entity ID (e.g., “Q7747”)

Example call

Arguments

{
  "id": "Q7747"
}

curl

curl -X POST https://gateway.pipeworx.io/open-sanctions/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_entity","arguments":{"id":"Q7747"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_entity', {
  "id": "Q7747"
});

Response shape

Always returns: id, caption, schema, datasets, target, score, first_seen, last_seen, last_change, names, countries, birth_date, nationality, topics, position, notes

Field	Type	Description
`id`	string \| null	OpenSanctions entity ID
`caption`	string \| null	Entity display name
`schema`	string \| null	Entity type (Person, Company, Organization, Vessel, Aircraft)
`datasets`	array	Datasets this entity appears in
`target`	boolean \| null	Whether entity is a sanctions target
`score`	number \| null	Search relevance score
`first_seen`	string \| null	Date entity first appeared
`last_seen`	string \| null	Date entity last appeared
`last_change`	string \| null	Date of last data change
`names`	array	Known names for this entity
`countries`	array	Associated country codes
`birth_date`	string \| null	Birth date if Person
`nationality`	array	Nationalities
`topics`	array	Associated topics/categories
`position`	string \| null	Position held if applicable
`notes`	array	Additional notes about entity

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "OpenSanctions entity ID"
    },
    "caption": {
      "type": [
        "string",
        "null"
      ],
      "description": "Entity display name"
    },
    "schema": {
      "type": [
        "string",
        "null"
      ],
      "description": "Entity type (Person, Company, Organization, Vessel, Aircraft)"
    },
    "datasets": {
      "type": "array",
      "description": "Datasets this entity appears in",
      "items": {
        "type": "string"
      }
    },
    "target": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether entity is a sanctions target"
    },
    "score": {
      "type": [
        "number",
        "null"
      ],
      "description": "Search relevance score"
    },
    "first_seen": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date entity first appeared"
    },
    "last_seen": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date entity last appeared"
    },
    "last_change": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date of last data change"
    },
    "names": {
      "type": "array",
      "description": "Known names for this entity",
      "items": {
        "type": "string"
      }
    },
    "countries": {
      "type": "array",
      "description": "Associated country codes",
      "items": {
        "type": "string"
      }
    },
    "birth_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Birth date if Person"
    },
    "nationality": {
      "type": "array",
      "description": "Nationalities",
      "items": {
        "type": "string"
      }
    },
    "topics": {
      "type": "array",
      "description": "Associated topics/categories",
      "items": {
        "type": "string"
      }
    },
    "position": {
      "type": [
        "string",
        "null"
      ],
      "description": "Position held if applicable"
    },
    "notes": {
      "type": "array",
      "description": "Additional notes about entity",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "id",
    "caption",
    "schema",
    "datasets",
    "target",
    "score",
    "first_seen",
    "last_seen",
    "last_change",
    "names",
    "countries",
    "birth_date",
    "nationality",
    "topics",
    "position",
    "notes"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "open-sanctions": {
      "url": "https://gateway.pipeworx.io/open-sanctions/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_entity