Skip to content
[Model Context Protocol]

Your AI can look it up now

One URL gives Claude, ChatGPT, Cursor and other MCP clients 8 tools backed by the whole catalog. Ask in plain language, get verified data in the reply.

Server URL
https://mcp.1lookup.dev/mcp
mcp.json
{
  "mcpServers": {
    "1lookup": {
      "url": "https://mcp.1lookup.dev/mcp"
    }
  }
}
Claude Code
claude mcp add --transport http 1lookup https://mcp.1lookup.dev/mcp
[01/Tools]

8 tools, the whole catalog

Three shortcuts for the most common checks, and run_lookup for everything else. search_products lets the model find the right product and its price before it spends anything.

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.

[02/In practice]

Things you can just ask

The model picks the tool, fills in the arguments and reads the JSON. You see the answer and, in your dashboard, the call and what it cost.

  • Is +1 512 555 0142 a mobile number, and is it on the Do Not Call list?
  • Verify these 20 emails and tell me which ones will bounce.
  • Look up the tech stack and domain age for northwind.example.
  • Screen Northwind Trading LLC against US sanctions lists.
  • How many credits do I have left, and what did I spend this week?
[03/How it works]

Connected in three steps

Step 01

Add the server

Paste the URL into your client's MCP or custom connector settings. Nothing to install and no code to write.

Step 02

Sign in

Authorize with OAuth, or use a dedicated API key for clients that do not support OAuth. You can revoke it at any time from the API keys page.

Step 03

Ask

Your assistant now has the tools. Every call draws from your normal credit balance and shows up in lookup history, labeled with the client that made it.

[05/FAQ]

MCP questions

What is the 1lookup.dev MCP server?

It is a Model Context Protocol server at https://mcp.1lookup.dev/mcp. Once you add it to an AI client, the model can call 1lookup.dev tools to validate a phone number, verify an email, look up an IP address, or run any other product by slug, then use the result in its answer.

Which clients can connect to it?

Claude, ChatGPT, Cursor and other MCP clients. Any client that supports remote MCP servers can use the URL. MCP access is included with every plan.

Which tools does it expose?

Eight tools. validate_phone, verify_email and lookup_ip cover the most common checks. run_lookup runs any product in the catalog by its slug, and search_products finds the right product and its credit cost for a task. bulk_submit and bulk_status start a bulk job and fetch its results, and get_account returns your credit balance, plan and recent usage.

How does the server know who I am?

The server is tied to your 1lookup.dev account, so tool calls are attributed to your credit balance. Add the URL in your client and complete the sign-in step it presents. Check the dashboard for the current setup instructions for your client.

How are credits spent when an agent calls a tool?

A tool call that runs a lookup spends the same credits as the equivalent API request, from the same balance. Cached results are free within 7 days, and failed requests are not charged. Ask the agent to call get_account to see your balance and recent usage, and use search_products to see a product's cost before running it.

[ Validate ][ Enrich ]
[Get started]

Give your assistant something to look up

Create a key, pick a plan and call any product in the catalog. Plans start at $29 a month.

[ Screen ][ Scrape ]