# Gapup KYC Screener

> Gapup KYC Screener is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-15).

Screens legal entities and individuals for sanctions, PEP status, and adverse media as part of a KYC/AML onboarding workflow

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/kyc_screener
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-kyc-screener-6a38a86a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cZNVEkbxcY2OOH54HASKH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gapup-kyc-screener-6a38a86a -d '<json body>'
```

Example prompt: Run a KYC screening on Acme Holdings Ltd, a UK-incorporated LLC with registration number 12345678, including sanctions, PEP, and adverse media checks with related parties, for a corporate-banking account onboarding in the UK — use standard risk appetite.

## When to prefer this

Use this endpoint when you need to perform structured KYC/AML compliance screening on one or more legal entities or individuals during an onboarding workflow, especially when you need sanctions, PEP, and adverse media checks in a single call with configurable risk appetite. Prefer this over generic search endpoints when you need compliance-grade screening with audit-ready onboarding packet metadata.

## Known failure modes

- Missing required fields (legalName, entityType, jurisdiction) returns 400 validation error
- Exceeding 20 entities in a single request returns a validation error
- Invalid enum value for entityType or accountType returns 400
- Authentication failure with invalid or missing API key returns 401
- Payment failure or insufficient balance returns 402
- Service timeout for large batches — use async:true to avoid client timeouts
- Empty or malformed onboardingPacket object triggers schema validation error

## How this service works

REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.

## Output

A JSON object containing the tool name ('kyc_screener'), a result object with screening outcomes per entity (sanctions hits, PEP status, adverse media findings, related party flags), and source metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  },
  "entities": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "legalName",
     "entityType",
     "jurisdiction"
    ],
    "properties": {
     "notes": {
      "type": "string",
      "maxLength": 300
     },
     "uboNames": {
      "type": "array",
      "items": {
       "type": "string",
       "maxLength": 150
      }
     },
     "legalName": {
      "type": "string",
      "maxLength": 200
     },
     "entityType": {
      "enum": [
       "LLC",
       "Ltd",
       "SA",
       "SAS",
       "GmbH",
       "BV",
       "LP",
       "Trust",
       "SPV",
       "Foundation",
       "individual",
       "other"
      ],
      "type": "string"
     },
     "jurisdiction": {
      "type": "string",
      "maxLength": 100
     },
     "incorporationDate": {
      "type": "string",
      "maxLength": 50
     },
     "registrationNumber": {
      "type": "string",
      "maxLength": 100
     }
    }
   },
   "maxItems": 20,
   "minItems": 1
  },
  "riskAppetite": {
   "enum": [
    "conservative",
    "standard",
    "liberal"
   ],
   "type": "string",
   "default": "standard"
  },
  "screeningScope": {
   "type": "object",
   "required": [
    "sanctions",
    "pep",
    "adverseMedia",
    "includeRelatedParties"
   ],
   "properties": {
    "pep": {
     "type": "boolean",
     "default": true
    },
    "sanctions": {
     "type": "boolean",
     "default": true
    },
    "adverseMedia": {
     "type": "boolean",
     "default": true
    },
    "includeRelatedParties": {
     "type": "boolean",
     "default": true
    }
   }
  },
  "onboardingPacket": {
   "type": "object",
   "required": [
    "accountType",
    "jurisdiction"
   ],
   "properties": {
    "requestId": {
     "type": "string",
     "maxLength": 100
    },
    "accountType": {
     "enum": [
      "corporate-banking",
      "private-banking",
      "fund-admin",
      "broker-dealer",
      "payment-institution",
      "other"
     ],
     "type": "string"
    },
    "submittedAt": {
     "type": "string",
     "maxLength": 50
    },
    "submittedBy": {
     "type": "string",
     "maxLength": 150
    },
    "jurisdiction": {
     "type": "string",
     "maxLength": 100
    }
   }
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "kyc_screener",
  "result": {},
  "source": "rest-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-kyc-screener-6a38a86a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)