Skip to content
MCP and AI agents

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

ToolWhat it does
validate_phoneValidity, carrier, line type and risk for a phone number.
verify_emailDeliverability, catch-all and disposable checks for an email.
lookup_ipLocation, ISP and VPN, proxy and Tor flags for an IP address.
run_lookupRun any product in the catalog by its slug.
search_productsFind the right product and its credit cost for a task.
bulk_submitStart a bulk job from a list of inputs.
bulk_statusCheck a bulk job and fetch its results.
get_accountCredit balance, plan and recent usage.

validate_phone

Validity, carrier, line type and risk for a phone number.

phone_numberstring<E.164>required

The 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>required

The 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>required

An IPv4 or IPv6 address.

Returns: The same result as the IP Intelligence endpoint.

run_lookup

Run any product in the catalog by its slug.

productstringrequired

The product slug, such as hlr-lookup or email-finder.

inputobjectrequired

The 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.

querystringrequired

What 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.

productstringrequired

The product slug to run for every input.

inputsobject[]required

One 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_idstringrequired

The 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.

tools/call
{
  "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.