SimilarContact in ChatGPT, Claude and your own code

1. Create your API key

1. 1

   Open the app

   Sign in with your Pro account and scroll to API & Integrations.
2. 2

   Create a key

   Give it a name like "Claude Desktop" and save it right away. For security it is shown only once and can never be retrieved again. On team accounts, only the team admin can create keys.
3. 3

   Keep it private

   Treat it like a password. Revoke it anytime from the same panel.

Claude Desktop

1. 1

   Open Claude's config

   In Claude Desktop go to Settings → Developer → Edit Config. Requires Node.js installed.
2. 2

   Paste this and add your key

   {
     "mcpServers": {
       "similarcontact": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "https://similarcontact.com/api/public/mcp",
                  "--header", "Authorization:${SC_AUTH}"],
         "env": { "SC_AUTH": "Bearer sc_live_YOUR_KEY" }
       }
     }
   }

3. 3

   Restart Claude and ask

   Try: "Find contacts similar to jane@acme.com using SimilarContact."

Any MCP-compatible tool (Cursor, Windsurf and others) can use the same server URL: https://similarcontact.com/api/public/mcp

ChatGPT (Custom GPT)

1. 1

   Create a GPT

   In ChatGPT open Explore GPTs → Create → Configure, then Create new action.
2. 2

   Import our schema

   Click Import from URL and paste:

   https://similarcontact.com/api/public/v1/openapi.json

3. 3

   Add your key

   Under Authentication choose API Key → Bearer and paste your key.
4. 4

   Save and ask

   Try: "Find three contacts like jane@acme.com."

Build whatever you want

Pipe matches into your CRM, a Slack bot, a spreadsheet or your own outreach workflow.

cURL

curl -X POST https://similarcontact.com/api/public/v1/lookup \
  -H "Authorization: Bearer sc_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@acme.com","product":"shippers"}'

Python

import requests

r = requests.post(
    "https://similarcontact.com/api/public/v1/lookup",
    headers={"Authorization": "Bearer sc_live_YOUR_KEY"},
    json={"email": "jane@acme.com", "product": "shippers"},
)
for c in r.json()["contacts"]:
    print(c["first_name"], c["last_name"], c["email"], c["company"])

JavaScript / TypeScript

const res = await fetch("https://similarcontact.com/api/public/v1/lookup", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMILARCONTACT_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: "jane@acme.com", product: "shippers" }),
});
const { contacts, credits_remaining } = await res.json();

Reference

{
  "product": "shippers",
  "prospect": { "company": "Acme", "industry": "...", "size": "51-200", "city": "Chicago", "state": "IL" },
  "contacts": [
    { "first_name": "Sam", "last_name": "Lee", "email": "sam@example.com",
      "company": "Example Co", "industry": "...", "company_size": "51-200", "location": "Dallas, TX" }
  ],
  "credits_remaining": 9
}