PayPerScreen MCP server

PayPerScreen

Pay-per-check compliance screening over x402. Sanctions names, crypto wallets, emails and IP addresses, paid per request in USDC on Base, Polygon or Arbitrum. No account, no API key, no contract.

• Hosted version: payperscreen.com (try it by hand at /try)
• API: https://api.payperscreen.com (docs, OpenAPI)
• Source: github.com/TonytheTiger22/payperscreen (MIT)
• How every check works, and what it doesn't cover: methodology

This repo is the whole thing: the paid API, the website, the case queue and the list ingest. Use the hosted version, or run your own.

What it checks

No LLM anywhere in the scoring. Every result says which sources it checked.

Calling it

Any x402 client works. The reference client is a single file:

PRIVATE_KEY=0x... node examples/agent-client.mjs screen "Jane Doe"

An unpaid request returns 402 Payment Required with the price; the client signs a USDC payment and retries.

Use it from Claude, Cursor or any MCP client

The mcp/ folder is an MCP server (npx -y payperscreen-mcp) that gives an AI agent screenname, screenwallet, checkemail and checkip tools, paying per check from a wallet you configure, with a spending cap. See mcp/README.md.

claude mcp add payperscreen -e PAYPERSCREEN_PRIVATE_KEY=0xYOUR_KEY -- npx -y payperscreen-mcp

Running your own

Two Node services from one repo, plus Postgres:

npm install
psql "$DATABASE_URL" -f schema.sql
node compliance-api.js        # API
npm start                     # website

API settings

Shortened. The full README is on GitHub.