`telnyx_number_lookup`

Pack: telnyx-lookup · Endpoint: https://gateway.pipeworx.io/telnyx-lookup/mcp

Look up carrier, caller-name (CNAM), and number-portability/LRN data for a phone number using the Telnyx Number Lookup API. Returns the carrier name and line type (mobile/landline/voip), the CNAM caller name, and portability details (ported status, local routing number, city/state). Example: telnyx_number_lookup({ phone_number: “+18665552368”, _apiKey: “your-key” })

Parameters

Name	Type	Required	Description
`phone_number`	string	yes	Phone number to look up, in E.164 format including the leading ”+” and country code, e.g. “+18665552368”.
`type`	array	no	Which enrichments to request: “carrier” (carrier name + line type) and/or “caller-name” (CNAM). Defaults to both. Portability data is always returned.
`items`	string	no
`_apiKey`	string	yes	Telnyx API key (created in the Mission Control portal at https://telnyx.com).

Example call

Arguments

{
  "phone_number": "+18665552368",
  "_apiKey": "your-telnyx-lookup-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/telnyx-lookup/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"telnyx_number_lookup","arguments":{"phone_number":"+18665552368","_apiKey":"your-telnyx-lookup-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('telnyx_number_lookup', {
  "phone_number": "+18665552368",
  "_apiKey": "your-telnyx-lookup-api-key"
});

More examples

{
  "phone_number": "+441632960123",
  "type": [
    "carrier",
    "caller-name"
  ],
  "_apiKey": "your-telnyx-lookup-api-key"
}

Connect

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

{
  "mcpServers": {
    "telnyx-lookup": {
      "url": "https://gateway.pipeworx.io/telnyx-lookup/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

telnyx_number_lookup