io.github.TonytheTiger22/payperscreen·Crypto

PayPerScreen

Sanctions, crypto wallet, email and IP screening for agents. Pay per check in USDC via x402.

Stars
0
Version
0.1.1
License
MIT
Review
Passed
Language
JavaScript
Last commit
1h ago
Forks
0
Open issues
0
Registry update
Oct 14, 2026
amlcryptocrypto-compliancekycofacsanctionsusdcx402

Connect

npm
Terminal
$claude mcp add payperscreen \  -e PAYPERSCREEN_PRIVATE_KEY=<payperscreen-private-key> \  -e PAYPERSCREEN_MAX_SPEND=<payperscreen-max-spend> \  -e PAYPERSCREEN_NETWORK=<payperscreen-network> \  -- npx -y [email protected]

Environment variables

  • PAYPERSCREEN_PRIVATE_KEYsecret

    Private key of a wallet holding a few dollars of USDC; pays 1 to 2 cents per check. Free tools work without it.

  • PAYPERSCREEN_MAX_SPEND

    Maximum USD the server may spend per session (default 1.00).

  • PAYPERSCREEN_NETWORK

    Where the wallet holds USDC: base (default), polygon or arbitrum.

Security review

Review passed

Reviewed 52m ago.

metadata
scanned
packages
1 checked

No findings.

Tools

This server runs on your machine, so its tool list is not fetched before install — the README below describes what it offers.

PayPerScreen MCP server

Give your AI agent compliance checks. Claude, Cursor or any MCP client can screen people, companies, crypto wallets, emails and IP addresses with PayPerScreen, paying 1 to 2 cents per check in USDC over x402. No account, no API key, no subscription.

ToolWhat it doesPrice
screen_namePerson or company against OFAC SDN, UN, EU and UK sanctions lists (refreshed daily). Each hit: listed name, score, record ID, programmes, aliases, and a date of birth / nationality / type comparison against what you pass$0.02
screen_walletWallet against every OFAC-sanctioned address (names the party), Tether's USDT freeze list on Tron, and FBI-identified hack wallets$0.02
check_emailTen deterministic fraud signals (disposable domain, domain age, blocklists, typo-squats…)$0.02
check_ipSpamhaus ZEN and Tor exit node check (beta)$0.01
lists_coverageWhich lists are checked, record counts, publication datesfree
sample_name_screen, sample_wallet_screenReal results for fixed examples, to see the formatfree
spending_statusWhat this session has spent against its capfree

Results are possible matches for review, not legal determinations. Bad input is never charged.

Set up

You need Node.js 20+ and, for the paid tools, a wallet with a few dollars of USDC on Base (or Polygon or Arbitrum). Use a dedicated wallet for this, not your main one: the key sits in your MCP client's config.

Claude Code

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

Claude Desktop (Settings → Developer → Edit config), Cursor (~/.cursor/mcp.json) and most other clients:

{
  "mcpServers": {
    "payperscreen": {
      "command": "npx",
      "args": ["-y", "payperscreen-mcp"],
      "env": {
        "PAYPERSCREEN_PRIVATE_KEY": "0xYOUR_KEY",
        "PAYPERSCREEN_MAX_SPEND": "1.00"
      }
    }
  }
}

Leave out the key to use only the free tools.

Settings

VariableDefaultPurpose
PAYPERSCREEN_PRIVATE_KEYnoneWallet that pays. Without it, paid tools explain how to add one
PAYPERSCREEN_MAX_SPEND1.00Spending cap in USD per session; checked before any payment is signed
PAYPERSCREEN_NETWORKbasebase, polygon or arbitrum: where your wallet holds USDC
PAYPERSCREEN_API_URLhttps://api.payperscreen.comAPI to call

No ETH or gas needed: you only sign a USDC authorization, and Coinbase's facilitator settles it.

How it works

Each paid tool calls the PayPerScreen API. The API answers 402 Payment Required with the price; the server signs a USDC payment from your wallet and retries; the result comes back with a receipt (amount, transaction, session total). See the API docs and methodology.

Develop

npm install
PAYPERSCREEN_API_URL=http://localhost:4025 PAYPERSCREEN_PRIVATE_KEY=0x... npm run test:e2e

MIT licence.

From the server's repository — third-party content, read it before running anything it suggests.

More in Crypto

Listing from the official MCP Registry · repository facts from GitHub, 54m ago.