screenSanctions
Returns ranked matches against the configured government sanctions lists. The set of lists and entity types available depends on subscription tier — Free covers OFAC SDN individuals only, Developer adds EU and entities, Business adds UK/UN/AU and vessels/aircraft.
This record as markdown: /tools/com-api-ninjas-mcp/screensanctions.md
What screenSanctions does on API Ninjas
AI agents use screenSanctions to create or update resources in API Ninjas, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your API Ninjas environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
dob | string | — | Date of birth (YYYY-MM-DD) to filter individual matches. Loose match: ±1 year. Developer tier and above. |
name | string | Yes | Name to screen. Full name, ordering doesn't matter. |
country | string | — | ISO 3166-1 alpha-2 country code to filter results by nationality/jurisdiction. Developer tier and above. |
sources | string | — | Comma-separated subset of OFAC,EU,UK,UN,AU to scope the screen to specific lists. Developer tier and above. |
min_score | integer | — | Minimum confidence score (0-100) to return. Default 70. Developer tier and above. |
entity_type | string | — | Restrict the screen to a specific entity type. Vessel and aircraft are Business tier and above. |
nationality | string | — | ISO 3166-1 alpha-2 nationality filter. Developer tier and above. |
Parameters from the server's own tool schema.
Why screenSanctions is rated Medium
An AI agent can call screenSanctions faster than any human can review: one bad instruction and it creates or modifies resources in API Ninjas by the hundred, each call as confident as the last.
Attacks that exploit this kind of access
The rule that runs screenSanctions safely
PolicyLayer is an MCP gateway: it sits between your AI agents and API Ninjas, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For screenSanctions, this is the rule to start with:
screenSanctions stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect API Ninjas, apply this rule, and every screenSanctions call is checked against it from then on.
Questions about screenSanctions
Returns ranked matches against the configured government sanctions lists. The set of lists and entity types available depends on subscription tier — Free covers OFAC SDN individuals only, Developer adds EU and entities, Business adds UK/UN/AU and vessels/aircraft. It is categorised as a Write tool in the API Ninjas MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
screenSanctions accepts 7 parameters: dob, name, country, sources, min_score, entity_type, nationality. Required: name. The full parameter table on this page comes from the server's own tool schema.
Register the API Ninjas MCP server in PolicyLayer and add a rule for screenSanctions: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches API Ninjas. Nothing to install.
screenSanctions is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the screenSanctions rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for screenSanctions. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
screenSanctions is provided by the API Ninjas MCP server (https://mcp.api-ninjas.com/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on API Ninjas, and thousands of servers like it.
This server
Across the catalogue