Client setup
Each client needs one thing from you: a URL, a config block or a command. Pick yours below.
Before you start
You need a 1lookup.dev account on a plan. Clients that sign in with OAuth need nothing else. Clients that use a key need one from API & MCP in the dashboard: create a key per client so you can revoke it on its own.
| Client | Signs in with | You provide |
|---|---|---|
| Claude | OAuth in the browser | Connector URL |
| ChatGPT | OAuth in the browser | Server URL |
| Cursor | An API key | mcp.json |
| VS Code | An API key | mcp.json |
| Claude Code | An API key | Terminal |
Claude
Add 1lookup.dev as a custom connector in Claude and sign in through the browser.
https://mcp.1lookup.dev/mcp- Open the connector settings in Claude and choose to add a custom connector.
- Name it 1lookup and paste the connector URL.
- Approve the sign-in page that opens, then enable the connector in a new chat.
ChatGPT
Add 1lookup.dev as a custom MCP server in ChatGPT and sign in through the browser.
https://mcp.1lookup.dev/mcp- Open the connectors or apps settings in ChatGPT and add a custom MCP server.
- Paste the server URL and choose OAuth when asked how to authenticate.
- Approve the sign-in page, then enable 1lookup in a new chat.
Cursor
Add the server to your MCP configuration in Cursor, with an API key in the header.
{
"mcpServers": {
"1lookup": {
"url": "https://mcp.1lookup.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}- Create an API key for Cursor under API & MCP in the dashboard.
- Open your MCP configuration file in Cursor, add the server block and save.
- Check that 1lookup shows as connected in the MCP settings.
VS Code
Add the server to your MCP configuration in VS Code and use it from Copilot Chat in agent mode.
{
"servers": {
"1lookup": {
"type": "http",
"url": "https://mcp.1lookup.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}- Create an API key for VS Code under API & MCP in the dashboard.
- Open your MCP server configuration in VS Code, add the server block and save.
- Start the server from the MCP view and switch Copilot Chat to agent mode.
Claude Code
Register the server from your terminal, with an API key in the header.
claude mcp add --transport http 1lookup https://mcp.1lookup.dev/mcp \
--header "Authorization: Bearer YOUR_API_KEY"- Create an API key for Claude Code under API & MCP in the dashboard.
- Run the command in your project.
- Start Claude Code and run /mcp to confirm 1lookup is listed.
Another client
Any client that supports remote MCP servers can connect. Find where it lists servers and add the URL below. Use OAuth if it is offered, otherwise send an API key as a Bearer header.
https://mcp.1lookup.dev/mcpCheck the connection
Ask the assistant to call get_account. It should answer with your credit balance. If the tools do not show up, confirm the URL has no trailing path beyond /mcp, and that the key has not been revoked. Then see MCP tools for what to ask next.