Skip to content
MCP and AI agents

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.

ClientSigns in withYou provide
ClaudeOAuth in the browserConnector URL
ChatGPTOAuth in the browserServer URL
CursorAn API keymcp.json
VS CodeAn API keymcp.json
Claude CodeAn API keyTerminal

Claude

Add 1lookup.dev as a custom connector in Claude and sign in through the browser.

Connector URL
https://mcp.1lookup.dev/mcp
  1. Open the connector settings in Claude and choose to add a custom connector.
  2. Name it 1lookup and paste the connector URL.
  3. 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.

Server URL
https://mcp.1lookup.dev/mcp
  1. Open the connectors or apps settings in ChatGPT and add a custom MCP server.
  2. Paste the server URL and choose OAuth when asked how to authenticate.
  3. 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.

mcp.json
{
  "mcpServers": {
    "1lookup": {
      "url": "https://mcp.1lookup.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  1. Create an API key for Cursor under API & MCP in the dashboard.
  2. Open your MCP configuration file in Cursor, add the server block and save.
  3. 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.

mcp.json
{
  "servers": {
    "1lookup": {
      "type": "http",
      "url": "https://mcp.1lookup.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  1. Create an API key for VS Code under API & MCP in the dashboard.
  2. Open your MCP server configuration in VS Code, add the server block and save.
  3. 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.

Terminal
claude mcp add --transport http 1lookup https://mcp.1lookup.dev/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
  1. Create an API key for Claude Code under API & MCP in the dashboard.
  2. Run the command in your project.
  3. 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.

Server URL
https://mcp.1lookup.dev/mcp

Check 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.