# ProofTell

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: prooftell
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/prooftell/integrations/tree/HEAD/mcp
- Updated: 2026-11-13
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/prooftell

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PROOFTELL_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -e PROOFTELL_API_KEY=<PROOFTELL_API_KEY> -- npx -y @prooftell/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env PROOFTELL_API_KEY=<PROOFTELL_API_KEY> -- npx -y @prooftell/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@prooftell/mcp"
            ],
            "env": {
                "PROOFTELL_API_KEY": "<PROOFTELL_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@prooftell/mcp"
            ],
            "env": {
                "PROOFTELL_API_KEY": "<PROOFTELL_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PROOFTELL_API_KEY=<PROOFTELL_API_KEY> mcp npx -y @prooftell/mcp
```
Replace <…> with your own values

## When to use it
- 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
- Check this phone number with ProofTell: +447700900123
- Assess the sign-up risk for user email jane@example.com and IP 203.0.113.1
- Get my current ProofTell balance

## Similar
- [Verified Handles](https://affpapa.org/en/nevibecode/mcp/verified-handles.md) — MCP server · ★ 16 repo stars
- [run.pay — Agent Marketplace](https://affpapa.org/en/nevibecode/mcp/runpay-agent-marketplace.md) — MCP server · 414 installs
- [sumsub-integrate-dint-websdk](https://affpapa.org/en/nevibecode/skills/sumsub-integrate-dint-websdk.md) — skill · 1200 installs
- [maxmind-minfraud](https://affpapa.org/en/nevibecode/skills/maxmind-minfraud.md) — skill · 183 installs
- [mcp-sift](https://affpapa.org/en/nevibecode/mcp/mcp-sift.md) — MCP server · ★ 279 repo stars
- [Kaidn](https://affpapa.org/en/nevibecode/mcp/kaidn.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
