Skip to content

Run lookups from Claude Code in your terminal

Claude Code can use remote MCP servers as tools. Register https://mcp.1lookup.dev/mcp and it can validate data, look up companies and start bulk jobs as part of a coding or data task in your terminal.

Connects via MCP server
MCP server
{
  "mcpServers": {
    "1lookup": {
      "url": "https://mcp.1lookup.dev/mcp"
    }
  }
}
[01/Setup]

Connect Claude Code in 4 steps

It suits scripted cleanup work. Claude Code can read a CSV from your project, submit it with bulk_submit, wait on bulk_status and write the enriched file back to disk. You register the server yourself in Claude Code's MCP configuration, and it authorizes with OAuth or an API key.

  1. 1

    Sign up for 1lookup.dev and note your API key if you plan to use key-based access.

  2. 2

    Register https://mcp.1lookup.dev/mcp as a remote HTTP MCP server in Claude Code's MCP configuration.

  3. 3

    Start a session and complete the OAuth sign-in, or configure the API key as a Bearer header.

  4. 4

    Ask Claude Code to call get_account to confirm the connection and see your credit balance.

[02/Recipes]

What to build with Claude Code

Clean a CSV in the repo

Point Claude Code at a contacts file and ask it to remove invalid emails. It submits the column as a bulk job, polls until it is done and writes a cleaned copy next to the original.

Write and verify an API client

Ask for a small client for the REST API. Claude Code can run HLR Lookup or Carrier Lookup through run_lookup first, then write code and fixtures that match the real response.

Audit DNS and TLS for your domains

Give it a list of domains and ask for a report. It runs DNS Lookup and SSL Certificate Check on each one and flags certificates that are close to expiry.

Claude Code is a trademark of its owner. This guide describes how to connect using our MCP server and REST API. 1lookup.dev is not affiliated with or endorsed by Claude Code.

[ Validate ][ Enrich ]
[Get started]

Run your first lookup in two minutes

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

[ Screen ][ Scrape ]