MCP tools
The server exposes 8 tools. Between them an assistant can run any of the 79 products, start a bulk job and check what it spent.
All tools
| Tool | What it does |
|---|---|
validate_phone | Validity, carrier, line type and risk for a phone number. |
verify_email | Deliverability, catch-all and disposable checks for an email. |
lookup_ip | Location, ISP and VPN, proxy and Tor flags for an IP address. |
run_lookup | Run any product in the catalog by its slug. |
search_products | Find the right product and its credit cost for a task. |
bulk_submit | Start a bulk job from a list of inputs. |
bulk_status | Check a bulk job and fetch its results. |
get_account | Credit balance, plan and recent usage. |
validate_phone
Validity, carrier, line type and risk for a phone number.
phone_numberstring<E.164>requiredThe number to check, with its country code.
Returns: The same result as the Phone Validation endpoint.
verify_email
Deliverability, catch-all and disposable checks for an email.
emailstring<email>requiredThe address to check.
Returns: The same result as the Email Validation endpoint.
lookup_ip
Location, ISP and VPN, proxy and Tor flags for an IP address.
ipstring<ip>requiredAn IPv4 or IPv6 address.
Returns: The same result as the IP Intelligence endpoint.
run_lookup
Run any product in the catalog by its slug.
productstringrequiredThe product slug, such as hlr-lookup or email-finder.
inputobjectrequiredThe same JSON body the product's REST endpoint takes.
Returns: The product's result, with the credits the call used.
search_products
Find the right product and its credit cost for a task.
querystringrequiredWhat you want to find out, in plain words.
Returns: Matching products with their slugs, input fields and credit prices.
bulk_submit
Start a bulk job from a list of inputs.
productstringrequiredThe product slug to run for every input.
inputsobject[]requiredOne object per row, with the product's fields.
Returns: A job id to pass to bulk_status.
bulk_status
Check a bulk job and fetch its results.
job_idstringrequiredThe id returned by bulk_submit.
Returns: The job's progress and, when it has finished, its results.
get_account
Credit balance, plan and recent usage.
This tool takes no arguments.
Returns: Your credit balance and recent usage.
Example call
This is what a client sends when the model decides to run a product through run_lookup. The arguments are the same slug and body you would send to the REST API.
{
"name": "run_lookup",
"arguments": {
"product": "hlr-lookup",
"input": {
"phone_number": "+15125550142"
}
}
}A tool call costs what the same REST call costs and appears in lookup history. See credits and billing.