ProofTell — Claude Code MCP server: what it does, how to install
MCP server for Claude Code and Cursor exposes phone, email, and IP checks via the ProofTell API. Scores user registration risks from 0 to 100 during chat sessions.
no license updated 2026-11-13
claude mcp add mcp -e PROOFTELL_API_KEY=<PROOFTELL_API_KEY> -- npx -y @prooftell/mcpWhat ProofTell does
The server runs locally over stdio and maps public ProofTell endpoints directly into model tools. It provides lookups for mobile carriers and phone line status, inbox deliverability tests, IP inspections, account balance checks, and a multi-factor risk assessment named assess_identity_risk.
Risk evaluations return a numeric score between 0 and 100, an allow, review, or deny verdict, and specific risk triggers. When issues happen, like insufficient_balance or rate limits, the server surfaces original API errors so the assistant can explain them.
Running it requires Node.js 18+ and an API token set in PROOFTELL_API_KEY. Keys starting with pt_test_ hit a deterministic free sandbox, while production keys with pt_live_ deduct funds per check from your account balance. The process stores no local state.
What it helps with
- check phone numbers for carrier and line type
- verify email deliverability and disposable status
- detect anonymous IP addresses or Tor nodes
- calculate a composite sign-up risk score from 0 to 100
- retrieve the active ProofTell account balance
Example prompts for the agent
- Check this phone number with ProofTell: +447700900123
- Assess the sign-up risk for user email [email protected] and IP 203.0.113.1
- Get my current ProofTell balance
How to install ProofTell
Platform CLI
claude mcp add mcp -e PROOFTELL_API_KEY=<PROOFTELL_API_KEY> -- npx -y @prooftell/mcpReplace <…> with your own values
Platform CLI
codex mcp add mcp --env PROOFTELL_API_KEY=<PROOFTELL_API_KEY> -- npx -y @prooftell/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@prooftell/mcp"
],
"env": {
"PROOFTELL_API_KEY": "<PROOFTELL_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@prooftell/mcp"
],
"env": {
"PROOFTELL_API_KEY": "<PROOFTELL_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e PROOFTELL_API_KEY=<PROOFTELL_API_KEY> mcp npx -y @prooftell/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ProofTell
How to install ProofTell in Claude Code?
Run claude mcp add mcp -e PROOFTELL_API_KEY=<PROOFTELL_API_KEY> -- npx -y @prooftell/mcp.
What does ProofTell do?
It adds MCP tools to query the ProofTell API for fraud detection, contact verification, and sign-up risk scores.
What is required to run ProofTell?
Node.js 18 or later and a valid PROOFTELL_API_KEY (either a free pt_test_ sandbox key or a paid pt_live_ production key).