@pipeworx/telnyx-lookup

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/telnyx-lookup’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 1

Carrier, caller-name (CNAM) and number-portability (LRN, ported status, line type) data for one E.164 phone number, plus Telnyx’s fraud flag, from the Telnyx Number Lookup API.

Tools

• telnyx_number_lookup(phone_number, type?, _apiKey) — one number in E.164 form (+18665552368). Returns the carrier name and line type (mobile/landline/voip), the CNAM caller name, and portability details (LRN, ported status and date, OCN/SPID, city/state). type selects carrier and/or caller-name; both are requested by default and portability data is always included.

Auth

BYO only. _apiKey is required in the tool schema, so the gateway refuses with error_class: auth_required (“requires an API key”) before any upstream request is made. Pipeworx does not front a Telnyx key for this pack — see scripts/vendors/intent.json → telnyx-lookup for the decision, the pay trigger, and where the Telnyx key minted on 2026-10-01 actually lives (it belongs to another product and is deliberately not shared).

Telnyx gates the API beyond registration: a new account must complete identity verification and add a payment method before Number Lookup answers. Until then every call returns an auth-shaped error that looks identical to a wrong key. Create keys in the Mission Control portal under API Keys.

Data sources

• https://api.telnyx.com/v2/number_lookup/{phone_number}?type=carrier&type=caller-name — the single endpoint. type is a repeatable query parameter with the hyphenated enum values carrier and caller-name. The phone number is a path segment and the leading + must be URL-encoded. Errors come back as { errors: [{ code, title, detail }] }; the pack surfaces the first detail.
• Pricing (read live 2026-10-08 from https://telnyx.com/ai/pricing.json): LRN $0.0015, MCC/MNC $0.0025, CNAM $0.003 per query, prepaid, no minimum.

Tools

• telnyx_number_lookup — 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 call