Connect Cursor to the 1Lookup MCP server
One entry in mcp.json points Cursor at the hosted 1Lookup MCP server, and the agent gets five tools for phone, email, and IP validation. OAuth handles authorization, so no key ever enters the file.
https://app.1lookup.io/api/mcpVerified in Cursor and Claude. Any client that supports remote MCP over streamable HTTP can use the same URL.
The whole config is one url
Paste this into Cursor's MCP configuration. Because the server is remote and hosted, there is no command to spawn and no local process.
{
"mcpServers": {
"1lookup": {
"url": "https://app.1lookup.io/api/mcp"
}
}
}Four steps, start to finish
Nothing runs on your machine, so there is no build step, no runtime to keep alive, and no version to upgrade.
- 01
Open Cursor's MCP settings
Cursor stores MCP servers as JSON. Use .cursor/mcp.json in a project to scope the server to that project, or ~/.cursor/mcp.json to make it available everywhere. 1Lookup needs one entry in either file.
- 02
Add the 1Lookup entry
One key, one url field, and nothing else. There is no command, no args, no package to install, and no API key or environment variable, because authorization happens in the browser instead of in the file.
- 03
Approve the connection in your browser
Cursor registers itself with the 1Lookup authorization server and opens a sign-in window. Sign in, review the access being requested, and approve. Cursor receives a scoped token, not your API key.
- 04
Let the agent call the tools
The five tools appear in Cursor and the agent can call them while it works. Each call bills to the 1Lookup plan you already have.
The five tools your agent gets
Each one is a single call the agent can make while it works. Three checks for phone, email, and IP, plus bulk for up to 50 values at a time and an account read so it can pace itself.
validate_phone
1 creditConfirms a number is real and active, and returns line type, carrier, DNC status, and a fraud score.
verify_email
1 creditChecks that an address exists and is deliverable, and flags disposable, role-based, and risky addresses.
ip_lookup
1 creditReturns geolocation and connection type, and flags proxy, VPN, Tor, and datacenter ranges.
bulk_verify
1 credit per recordValidates up to 50 phones, emails, or IPs in one call and returns a per-item result array.
get_account
FreeReturns the plan, subscription status, and remaining credit balance so an agent can pace itself.
What a tool call costs
Tool calls spend the same universal credits as the REST API. There is no separate MCP fee and no second bill to set up.
One credit per lookup
One credit per phone, email, or IP lookup, and one credit per record for bulk_verify. get_account is free, so an agent can check its balance before a large run without spending anything.
A paid plan is required
Programmatic access is a paid feature. A free-plan account receives HTTP 403 UPGRADE_REQUIRED on every tool call. A 7-day trial is available if you want to test the connection first.
Questions people actually ask
What goes in the file, what it costs, and what a free-plan account gets back.
What goes in mcp.json for 1Lookup?
One entry with a single url field pointing at https://app.1lookup.io/api/mcp. There is no command, no args, no package to install, and no API key or environment variable, because authorization happens over OAuth in the browser instead of in the file.
Do I need to install anything for Cursor to use 1Lookup?
No. The 1Lookup MCP server is hosted and remote, so Cursor connects to the URL over streamable HTTP. Nothing runs on your machine and there is no SDK or CLI to install.
What does a 1Lookup tool call cost in Cursor?
Cursor charges nothing on top of your 1Lookup plan; a tool call spends the same credit a REST call would. One credit per phone, email, or IP lookup, one credit per record for bulk_verify, and get_account is free. An agent running unattended in Cursor can call get_account first to check the balance before a long run.
Does the free plan work with Cursor?
No. Programmatic access is a paid feature, so a free-plan account gets HTTP 403 UPGRADE_REQUIRED on every tool call. The connection itself still succeeds, so mcp.json can look correct while every call comes back rejected; it is the plan gate, not the config. A 7-day trial covers testing.
Add it to Cursor in about a minute
Paste the entry into mcp.json, approve the connection in the browser, and your agent can check any phone, email, or IP against the plan you already have.
https://app.1lookup.io/api/mcpProgrammatic access is a paid feature. A 7-day trial is available.