scamverify-mcp

ScamVerify MCP Server

AI-powered scam and threat verification MCP server. Verify phone numbers, URLs, text messages, emails, documents, and QR codes against 10M+ threat intelligence records from FTC, FCC, URLhaus, ThreatFox, and community reports.

Server URL: https://scamverify.ai/api/mcp

Transport: Streamable HTTP (stateless) or stdio (local proxy)

Authentication: API key or OAuth 2.1 (PKCE)

Tools (10)

| Tool | Description | |------|-------------| | check_phone | Look up a US phone number for scam reports, carrier info, robocall flags, and community reports. Returns risk score (0-100), verdict, and detailed signals from FTC, FCC, carrier, and community data. | | check_url | Check a website URL for safety. Analyzes domain age, SSL certificate, redirect chains, brand impersonation, Google Web Risk, URLhaus, ThreatFox, and community reports. | | check_text | Analyze a text/SMS message for scam indicators. Extracts and cross-references embedded phone numbers and URLs. AI identifies scam type, red flags, and risk level. | | check_email | Analyze an email for phishing indicators. Checks sender domain, email headers (SPF/DKIM/DMARC), brand impersonation, embedded URLs and phone numbers. | | check_document | Analyze a document image for scam indicators. Uses vision AI to extract entities (addresses, officials, citations, phone numbers) and verifies them against government databases. | | check_qr | Scan a QR code image and verify its contents. Decodes the QR code server-side and, if it contains a URL, runs full URL verification. | | batch_phone | Look up multiple phone numbers in a single request (max 100). | | batch_url | Check multiple URLs in a single request (max 100). | | get_usage | Check your current API usage quota and rate limits for the billing period. | | get_status | Check the operational status of ScamVerify API services. No authentication required. |

Prompts (4)

| Prompt | Description | |--------|-------------| | investigate_phone | Investigate a suspicious phone number for scam indicators and provide a safety recommendation. | | verify_url | Check if a website URL is safe to visit and provide a detailed safety assessment. | | analyze_text | Analyze a suspicious text message for scam indicators and explain the findings. | | check_email | Analyze a suspicious email for phishing indicators and provide a safety assessment. |

Data Sources

• FTC Do Not Call Complaints - 9.7M+ records with scam type classification
• FCC Consumer Complaints - 443K+ telecom violation reports
• URLhaus - 74K+ active malicious URL indicators
• ThreatFox - 60K+ IOCs (indicators of compromise)
• Carrier Intelligence - Line type, CNAM, VoIP detection, high-risk carrier flagging
• Community Reports - User-submitted scam reports with verification

Setup

Option 1: Remote Server (Recommended)

Connect directly to the hosted ScamVerify MCP server. No installation required.

Claude Desktop:

{
  "mcpServers": {
    "scamverify": {
      "type": "streamable-http",
      "url": "https://scamverify.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop (OAuth - no API key needed):

{
  "mcpServers": {
    "scamverify": {
      "type": "streamable-http",
      "url": "https://scamverify.ai/api/mcp"
    }
  }
}

When using without an API key, Claude Desktop will initiate the OAuth 2.1 flow. You'll be redirected to sign in at scamverify.ai and authorize access.

Cursor / Windsurf / Other MCP Clients:

{
  "type": "streamable-http",
  "url": "https://scamverify.ai/api/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

ChatGPT:

ScamVerify is available as a ChatGPT connector. Add it through the ChatGPT plugin/connector settings using:

• MCP URL: https://scamverify.ai/api/mcp
• Auth: OAuth

Option 2: Local Proxy (stdio)

Run a local MCP server that proxies all tool calls to the ScamVerify API. Useful for MCP clients that only support stdio transport.

Install and run:

npm install -g @scamverifyai/scamverify-mcp
SCAMVERIFY_API_KEY=sv_live_... scamverify-mcp

Or run directly with npx:

SCAMVERIFY_API_KEY=sv_live_... npx @scamverifyai/scamverify-mcp

Claude Desktop (stdio):

{
  "mcpServers": {
    "scamverify": {
      "command": "npx",
      "args": ["@scamverifyai/scamverify-mcp"],
      "env": {
        "SCAMVERIFY_API_KEY": "sv_live_..."
      }
    }
  }
}

Docker:

docker build -t scamverify-mcp .
docker run -e SCAMVERIFY_API_KEY=sv_live_... scamverify-mcp

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | SCAMVERIFY_API_KEY | Yes | Your API key (prefix: sv_live_ for production, sv_test_ for testing) | | SCAMVERIFY_API_URL | No | Override the API base URL (default: https://scamverify.ai) |

Getting an API Key

1. Sign up at scamverify.ai
2. Go to Settings > API Keys
3. Generate a key (prefix: sv_live_ for production, sv_test_ for testing)

OAuth 2.1 Authentication

The remote server supports OAuth 2.1 with PKCE (S256). Discovery endpoints:

• Authorization Server: https://scamverify.ai/.well-known/oauth-authorization-server
• Protected Resource: https://scamverify.ai/.well-known/oauth-protected-resource

OAuth scopes: phone:lookup, url:lookup, text:analyze, email:analyze, usage:read

Development

git clone https://github.com/scamverifyai/scamverify-mcp.git
cd scamverify-mcp
npm install
npm run build
SCAMVERIFY_API_KEY=sv_test_... npm start

Pricing

A free tier (50 lookups/month) is automatically provisioned on first OAuth login or API key creation.

| Plan | Monthly Price | Lookups/mo | Rate Limit | |------|--------------|------------|------------| | Free | $0 | 50 | 10 RPM | | Starter | $19/mo | 1,000 | 30 RPM | | Growth | $49/mo | 5,000 | 60 RPM | | Pro | $149/mo | 25,000 | 120 RPM | | Scale | $499/mo | 100,000 | 300 RPM | | Enterprise | Custom | Custom | Custom |

Full API documentation: docs.scamverify.ai

Links

• Website: scamverify.ai
• API Docs: docs.scamverify.ai
• MCP Integration Guide: docs.scamverify.ai/docs/guides/mcp-integration
• OAuth Flow Guide: docs.scamverify.ai/docs/guides/oauth-flow
• Status Page: status.scamverify.ai
• Contact: scamverify.ai/contact

License

MIT