Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add mcp -e PROOFTELL_API_KEY=<PROOFTELL_API_KEY> -- npx -y @prooftell/mcp
Open on GitHub

What 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/mcp

Replace <…> 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).

Similar MCP servers

All MCP servers for Security →

Project sponsors

Companies that keep this analytics open