Plug ContactSearch into your workflow

Two ways to connect

Pick the one that fits how you work. Both use the same account and the same credits — nothing new to learn about billing.

MCP — Source from inside Claude or ChatGPT Claude & ChatGPT

MCP (Model Context Protocol) is the standard way to give an AI assistant access to an outside service. Connect once and Claude — or ChatGPT — can search, preview, reveal and push contacts to your ATS, all from a normal chat.

What Claude can do for you

Connect in about 2 minutes

The server endpoint is the same everywhere:

https://contactsearch.ai/api/mcp

On claude.ai (web) — easiest, recommended

1. Settings → Connectors → Add custom connector.
   In Claude on the web, open your profile settings and find Connectors.
2. Paste the endpoint https://contactsearch.ai/api/mcp and click Connect.
3. Sign in with your ContactSearch account.
   A secure sign-in window opens. Approve access — your password and API key never get pasted into Claude.
4. Start chatting.
   Try: "Find me Directors of Nursing hiring near Chicago and show the first 25."

On Claude Desktop

Add this to your claude_desktop_config.json (Settings → Developer → Edit config), then restart Claude Desktop. Replace the key with your own from Settings → Integrations.

{
  "mcpServers": {
    "contactsearch": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://contactsearch.ai/api/mcp",
        "--header", "Authorization:Bearer cs_live_YOUR_KEY_HERE"
      ]
    }
  }
}

On Claude Code (CLI)

claude mcp add --transport http contactsearch \
  https://contactsearch.ai/api/mcp \
  --header "Authorization: Bearer cs_live_YOUR_KEY_HERE"

On ChatGPT (custom connector)

Needs a paid ChatGPT plan, on the web. Tip: sign in to ContactSearch in another tab first, so the sign-in step is instant.

1. Turn on Developer Mode.
   ChatGPT Settings → Apps → Advanced settings, then toggle Developer mode on.
2. Create app / Add custom connector and enter: Name ContactSearch, Description a short summary, MCP Server URL https://contactsearch.ai/api/mcp, Authentication OAuth, and upload the logo (download).
3. Create and approve the ContactSearch consent screen.
4. Use it: new chat → + → More → Developer mode → select ContactSearch, then ask away.

What it looks like

Get an account to connect →

API — Pull data into your tools REST v1

A clean, read-only REST API for your contacts, companies and jobs. Point any HTTP tool at it — n8n, Make, Zapier, a Google Sheet script, or your own code — and pull data on your own schedule.

The basics

• Read-only & tenant-scoped. Every key belongs to one account and only ever returns your own data.
• Simple auth. One API key, sent as a Bearer token.
• Predictable. JSON responses, stable error codes, and a rate limit of 60 requests/minute by default.

Authentication

Send your key in the Authorization header:

curl -H "Authorization: Bearer cs_live_YOUR_KEY_HERE" \
  "https://contactsearch.ai/api/v1/contacts?state=IL&per_page=25"

Endpoints

What a response looks like

{
  "contacts": [ { "id": 12345, "name": "Sarah J.", "title": "Director of Nursing", ... } ],
  "page": 1,
  "per_page": 50,
  "total": 1247,
  "has_more": true
}

Want every parameter, error code and best practice? See the full technical reference:

Full API reference →

Getting your key

One key works for both the API and Claude Desktop / Claude Code. (On claude.ai web you just sign in — no key needed.)

1. Sign in and open Settings → Integrations.
   You'll need an approved ContactSearch account.
2. Create an API key.
   It looks like cs_live_a1b2c3d4…. Copy it now — it's only shown once.
3. Paste it where you need it — the API header, or your Claude Desktop / Claude Code config above.
4. Revoke anytime.
   Lost a key or changed tools? Revoke it in one click; the audit log keeps the trail.