# Yield.xyz KYC Status Checker

> Yield.xyz KYC Status Checker is a paid API for AI agents from mcp.yield.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-28).

Checks whether a wallet address is KYC-eligible for a specific gated (RWA/tokenized-treasury) yield and returns the normalized KYC status plus verification instructions if needed.

## Facts

- Endpoint: POST https://mcp.yield.xyz/x402/yields_get_kyc_status?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yield-xyz-kyc-status-checker-e69dc322
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HHZ8TlBSOdc2cEJItGmzk

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 yield-xyz-kyc-status-checker-e69dc322 -d '<json body>'
```

Example prompt: Before I enter the OUSG tokenized treasury yield on Yield.xyz, check whether my wallet 0xAbC123...def456 is KYC-eligible and tell me where to complete verification if I'm not cleared yet.

## When to prefer this

Use this endpoint before calling actions_enter on any gated yield (RWA, tokenized treasury, or regulated protocol) on Yield.xyz. It is the required pre-flight check to determine if a wallet can legally participate in a compliance-gated yield, and it surfaces exactly where to complete verification if the wallet is not yet cleared.

## Known failure modes

- Invalid wallet address format — returns 400 or validation error
- Unknown yieldId — returns error indicating the yield does not exist or is not gated
- Yield is not gated and requires no KYC — may return a no-op or open status
- Network timeout or upstream KYC provider unavailability — returns 503
- Missing required fields (address or yieldId) — returns schema validation error

## How this service works

Check whether a wallet is KYC-eligible for a gated (RWA / tokenized-treasury) yield. Returns the normalized KYC status and, when required, where to complete verification — call before actions_enter on gated yields.

## Output

Returns the normalized KYC status for the wallet-yield pair (e.g. approved, pending, rejected, not_started), along with a redirect URL or instructions for completing verification when the wallet is not yet eligible.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "Wallet address to check eligibility for"
  },
  "yieldId": {
   "type": "string",
   "description": "Gated yield ID, e.g. an RWA/treasury yield"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kycStatus": "REQUIRED",
  "authorizeUrl": "https://…"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yield-xyz-kyc-status-checker-e69dc322/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.yield.xyz](https://www.zero.xyz/host/mcp.yield.xyz/llms.txt)