`check_phone`

Pack: ipqualityscore · Endpoint: https://gateway.pipeworx.io/ipqualityscore/mcp

Phone number validation & fraud check. Confirms whether a number is valid and active, returns a 0-100 fraud score, and flags VOIP, prepaid, and risky numbers with line type, carrier, and region. Example: check_phone({ phone: “18007267864”, country: “US” }) Requires your own IPQualityScore API key, passed as _apiKey.

Parameters

Name	Type	Required	Description
`phone`	string	yes	Phone number to validate, e.g. “18007267864” or “+1 800 726 7864”
`country`	string	no	Optional 2-letter ISO country code to improve parsing, e.g. “US”, “GB”.
`_apiKey`	string	yes	Your own IPQualityScore API key (BYO — Pipeworx does not supply one). Free tier at ipqualityscore.com; the key is on the account dashboard.

Example call

Arguments

{
  "_apiKey": "your-ipqualityscore-api-key",
  "phone": "18007267864"
}

curl

curl -X POST https://gateway.pipeworx.io/ipqualityscore/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_phone","arguments":{"_apiKey":"your-ipqualityscore-api-key","phone":"18007267864"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('check_phone', {
  "_apiKey": "your-ipqualityscore-api-key",
  "phone": "18007267864"
});

More examples

{
  "_apiKey": "your-ipqualityscore-api-key",
  "phone": "+1 800 726 7864",
  "country": "US"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "ipqualityscore": {
      "url": "https://gateway.pipeworx.io/ipqualityscore/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

check_phone