`sanctions_bulk`

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

Batch-screen up to 10,000 records against sanctions/PEP/watchlists in one request. Pass a records array of objects (each with a name, plus optional entity_type/external_identifier/date_of_birth/identifier/country). Top-level min_score/data_source/entity_type act as defaults applied to any record that omits them. Example: sanctions_bulk({ records: [{ name: “Vladimir Putin”, external_identifier: “cust-1” }, { name: “Acme Corp”, external_identifier: “cust-2” }], min_score: 0.9, _apiKey: “your-key” })

Parameters

Name	Type	Required	Description
`records`	array	no	Records to screen (up to 10,000). Each item: { name (required), entity_type?, external_identifier?, data_source?, min_score?, country?, date_of_birth?, identifier? }
`item`	unknown	no
`items`	object	no	Name to screen
`properties`	string	no	Name to screen
`name`	string	yes	Name to screen
`entity_type`	string	no	”individual” or “entity” (optional)
`external_identifier`	string	no	Your own internal ID for correlating this record to its result (optional)
`data_source`	string	no	Watchlist source(s) for this record (optional)
`min_score`	number	no	Per-record minimum score (optional)
`country`	string	no	Country filter (optional)
`date_of_birth`	string	no	YYYY-MM-DD (optional)
`identifier`	string	no	Known identifier (optional)
`min_score`	number	no	Default minimum match score applied to records that omit their own. Default 0.88.
`data_source`	string	no	Default comma-separated watchlist source(s) applied to records that omit their own (optional)
`entity_type`	string	no	Default entity_type applied to records that omit their own (optional)
`_apiKey`	string	no	sanctions.io API token

Example call

Arguments

{
  "records": [
    {
      "name": "Vladimir Putin",
      "entity_type": "individual",
      "external_identifier": "cust-001"
    },
    {
      "name": "Acme Corp",
      "entity_type": "entity",
      "external_identifier": "cust-002"
    }
  ],
  "min_score": 0.9,
  "_apiKey": "your-sanctions-io-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/sanctions-io/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"sanctions_bulk","arguments":{"records":[{"name":"Vladimir Putin","entity_type":"individual","external_identifier":"cust-001"},{"name":"Acme Corp","entity_type":"entity","external_identifier":"cust-002"}],"min_score":0.9,"_apiKey":"your-sanctions-io-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('sanctions_bulk', {
  "records": [
    {
      "name": "Vladimir Putin",
      "entity_type": "individual",
      "external_identifier": "cust-001"
    },
    {
      "name": "Acme Corp",
      "entity_type": "entity",
      "external_identifier": "cust-002"
    }
  ],
  "min_score": 0.9,
  "_apiKey": "your-sanctions-io-api-key"
});

More examples

{
  "records": [
    {
      "name": "Jane Smith",
      "date_of_birth": "1975-03-15",
      "external_identifier": "emp-042",
      "country": "GB"
    },
    {
      "name": "XYZ Trading Ltd",
      "identifier": "GB123456789",
      "external_identifier": "vendor-108"
    }
  ],
  "data_source": "FATF,PEP",
  "_apiKey": "your-sanctions-io-api-key"
}

Connect

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

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

See Getting Started for client-specific install steps.

sanctions_bulk