About LookupLab
LookupLab is an MCP service for phone carrier, email-domain, IP-network, and DNS checks using a LookupLab account. It is for clients that need these lookups, with account-credit charges applied to tool calls.
Key features
- 01Check phone carrier and line type
- 02Verify email syntax and domain indicators
- 03Look up approximate IP location and network
- 04Check MX, SPF, DMARC, and DKIM
Use cases
- 01Identify a phone number's carrier and line type
- 02Inspect mail records for an email domain
- 03See an IP address's approximate location and network
- 04Check a domain's DNS configuration
MCP support
It exposes phone, email, IP, and DNS lookup tools to MCP clients. It connects over Streamable HTTP, and calls debit account credits.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://lookuplab.io/api/mcpclaude mcp add --transport http ppineapple-lookuplab https://lookuplab.io/api/mcp{"mcpServers":{"ppineapple-lookuplab":{"type":"http","url":"https://lookuplab.io/api/mcp"}}}Open in Cursor{"servers":{"ppineapple-lookuplab":{"type":"http","url":"https://lookuplab.io/api/mcp"}}}Open in VS Code{"mcpServers":{"ppineapple-lookuplab":{"type":"http","url":"https://lookuplab.io/api/mcp"}}}{"mcpServers":{"ppineapple-lookuplab":{"serverUrl":"https://lookuplab.io/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://lookuplab.io/api/mcpAuth requiredTools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| number | string | Yes | Phone number, preferably E.164 international format. |
| caller_name | boolean | No | Request caller-name data; adds 2 credits. |
Details
From the project READMELookupLab integrations
Phone carrier, email-domain, IP-network and DNS checks through LookupLab.
Find LookupLab on Smithery and in the official MCP Registry.
Claude web and Desktop
- Open Customize > Connectors > Add custom connector. Name it LookupLab and use
https://lookuplab.io/api/mcp. - Choose Sign in now and Register automatically if Claude shows authentication options. Leave a custom client ID and secret blank.
- On LookupLab's consent page, enter your LookupLab key and approve. Enable the connector in your chat. Try: "Check the mail records for example.com."
Your key goes only to LookupLab; Claude receives a revocable OAuth connection. On Team and Enterprise plans, an owner first adds the connector, then each member connects their account. See Claude's connector setup.
Claude Code
Set LOOKUPLAB_API_KEY privately in your environment, then merge claude-code.mcp.json into your project's .mcp.json. Start Claude Code in that project, approve LookupLab when prompted, and check /mcp. Keep the variable reference in the file; never replace it with a real key in a shared repository.
The config uses Claude Code's HTTP transport and environment expansion. Try: "Check the mail records for example.com."
Gemini CLI
Install with gemini extensions install https://github.com/PpiNeaPpLe/lookuplab-integrations. Supply your existing LookupLab API key in the extension's sensitive setting. Gemini stores this setting in its system keychain when available. Never put a key in a chat message.
Other MCP clients
Connect to https://lookuplab.io/api/mcp with Authorization: Bearer YOUR_API_KEY or X-API-Key: YOUR_API_KEY in the client's secure connection settings. The server uses Streamable HTTP with JSON responses and no SSE stream.
ChatGPT and Codex
The openai/ directory is the portable plugin package. OAuth needs an exact callback registered by LookupLab before the platform connection can run. This source package is not a claim of directory approval or publication.
Tools and costs
| Tool | Checks | Account credits |
|---|---|---|
phone_lookup | Carrier, line type; optional caller name | 1 for landline/VoIP/toll-free, 3 mobile/unknown; caller name adds 2 |
email_verify | Syntax, MX and domain indicators | 1 |
ip_lookup | Approximate location and network | 1 |
dns_check | MX, SPF, DMARC or DKIM | 1 |
The account needs enough balance for the maximum charge before the lookup runs. Failed/invalid results are not charged. Tools debit credits, so they are marked as operations with side effects. Duplicate calls may charge again unless your client sends a stable Idempotency-Key header for retries.
Data is not proof of a person's identity, ownership, consent to contact, guaranteed email delivery or precise location. Privacy flags can be unavailable. Supply only data you are authorized to check.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.