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
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":{}}}'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.