3 tools · your own account · never metered

HLR Lookup: connect your own account

Check whether a mobile number is live on its network right now, and which network serves it. Connect your own HLR Lookup account once and your agent uses it from then on, through one treg.to token. Calls on your own connection are never metered.

Start free See all 3 tools API docs ↗

$1.00 of free credit once per new verified account · no card · platform tools need no provider signup

3 of 3 tools on this page are live-verified against the provider.

works in

What your agent can now do

HLR Lookup, one prompt away

AGENT

check whether a phone number is live on its network✓

find the network that currently serves a phone number, including whether it was ported✓

validate and format a phone number✓

→

▚ treg

$ treg call hlrlookup.people.phone.verify

✓ 200 · $0.00661-$0.0132/success

$ treg call hlrlookup.people.phone.network

✓ 200 · $0.0033/success

$ treg call hlrlookup.people.phone.validate

✓ 200 · free

$ _

→

HLR LookupYOUR ACCOUNT

Check whether a mobile number is live on its network right now, and which network serves it.

⚒ 3 TOOLS

Enrichment · https://api.hlrlookup.com

Set up

Set up HLR Lookup in Claude Code, Codex or any agent

1Give this to your agent

in your agent's chat

set up treg — https://treg.sciatafrica.com/llms.txt

2Or add the MCP server yourself

claude code

claude mcp add --transport http treg https://treg.sciatafrica.com/mcp

ChatGPT

Settings → Connectors → add https://treg.sciatafrica.com/mcp as a custom connector.

Grok bot

Add https://treg.sciatafrica.com/mcp as a remote MCP connector in its tool settings.

Claude Desktop

Settings → Connectors → Add custom connector → https://treg.sciatafrica.com/mcp.

Cursor, Codex, any MCP client

Point it at https://treg.sciatafrica.com/mcp (HTTP transport).

CLI

curl -fsSL https://treg.sciatafrica.com/install.sh | sh

Plain HTTP

LangChain, CrewAI or any code: /call/<tool-id> + X-Treg-Token: <token>. No SDK.

Try it

What's the best way to ask?

the prompt

Using treg, check whether a phone number is live on its network. Show me the price first.

Run one directly

a live-verified call

treg call hlrlookup.people.phone.verify --method POST --data '{"telephone_number":"447540822872","save_to_cache":"PRIVATE","cache_days_global":0,"cache_days_private":0}'

Why treg.to

Why call HLR Lookup through treg.to

Your account, held safely

Connect once; treg.to keeps the credential server-side and injects it per call. No key on any machine.

Price before the call

The provider's own rate, $0.000 markup. How billing works.

Account billing

Calls through your own connection are not metered by treg.

Your own HLR Lookup key is free

Switch by changing a word

Another provider is a different word in the prompt, not a new integration.

One key, the whole catalog

The same token calls Tomba, TrestleIQ and 3,613 other tools.

The shelf

All 3 HLR Lookup tools

People & contact data · 3 tools

Find which network serves a phone number · BYOK only · live-verified · No treg charge; upstream $0.0033/success
Mobile Number Portability lookup returning the original and current network and porting information, without a live status. hlrlookup.people.phone.network
Half the price of an HLR lookup. A live mobile lookup reported credits_spent 0.5 and lowered the balance by half a credit. NO_COVERAGE, NOT_APPLICABLE and per-result errors are free. treg settles results[0].credits_spent.
Validate and format a phone number · BYOK only · live-verified · No treg charge; upstream free
Validates the number and returns number type, issuing network and formatted output without a live HLR lookup. hlrlookup.people.phone.validate
Check if a phone number is live · BYOK only · live-verified · No treg charge; upstream $0.00661-$0.0132/success
Performs a live HLR lookup, returning number type, live status, original and current network, and porting information. Warning: a national number sent without input_format can be read as another country's number (a US 617... number as an Australian 61... number), and that lookup is still charged. hlrlookup.people.phone.verify
One credit per live mobile lookup; a US mobile with usa_status YES costs two. Landlines, NO_COVERAGE, BAD_FORMAT, per-result errors and HTTP 4xx/5xx are free. A live mobile lookup reported credits_spent 1 and lowered the balance by one credit; a landline reported 0 and left it unchanged. A US mobile with usa_status YES reported credits_spent 2 and lowered the balance by two credits. treg reserves from usa_status and settles results[0].credits_spent.

Reliability badges come from live traffic through treg.to. Live-verified means a successful provider check; it does not verify every request variant.

Questions

Before you start

Do I need a HLR Lookup account?

Yes. This is an own-account connection: you sign in to HLR Lookup once and your agent uses that connection through your treg.to token. Calls on it are never metered.

How do I add HLR Lookup to Claude Code?

Run: claude mcp add --transport http treg https://treg.sciatafrica.com/mcp. One MCP server carries HLR Lookup and the rest of the catalog.

Which frameworks does it work with?

Anything that speaks MCP (Claude Code, Claude Desktop, ChatGPT, Codex, Cursor, Grok) and anything that can make an HTTP request (LangChain, CrewAI, LlamaIndex, plain code).

Is this the official HLR Lookup MCP server?

No. treg.to serves HLR Lookup's real API through its own metered proxy: the request is the provider's own, the credential is injected server-side, and the answer is relayed verbatim. The official HLR Lookup channels are linked above.