Skip to content

Integrations & MCP

KOL Luminary MCP Connector

Connect your KOL Luminary workspace directly inside Claude, Claude Code, and ChatGPT to search your saved library, inspect source-backed profiles, and launch new KOL discovery searches.

  • Streamable HTTP
  • OAuth 2.1 + PKCE
  • Claude & ChatGPT

Claude (web, Desktop, Mobile & Cowork)

Connect in Claude

  1. Open Settings → Connectors (or Customize → Connectors) and choose Add custom connector (or select KOL Luminary from the Connectors Directory).
  2. Enter the remote MCP Server URL: https://mcp.kolluminary.com/mcp
  3. Click Connect and sign in with your KOL Luminary account on kolluminary.com.
  4. Choose the workspace to authorize and click Authorize & Connect.

ChatGPT & Claude Code

Other supported surfaces

ChatGPT

Enable the KOL Luminary plugin/app from the ChatGPT directory or connect via https://mcp.kolluminary.com/mcp using OAuth.

Claude Code CLI

claude mcp add --transport http kol-luminary https://mcp.kolluminary.com/mcp

Prerequisites & billing

Reading projects, searching your saved workspace library, and viewing KOL profiles use mcp:read and do not consume search credits. Launching new discovery searches with start_kol_search requires an active workspace subscription or pre-purchased KOLs on Demand credits on kolluminary.com/pricing. All purchases happen exclusively on kolluminary.com.

Available MCP tools

list_projectsRead-only (mcp:read)

Lists active and draft projects in your authorized workspace (including Quick Searches) with candidate and shortlist counts.

search_library_kolsRead-only (mcp:read)

Searches saved Key Opinion Leaders (KOLs) and Digital Opinion Leaders (DOLs) already in your workspace library at zero search credit cost.

get_kol_profileRead-only (mcp:read)

Returns structured positions, recent publications, clinical trials, congress roles, speaking activities, guideline authorship, social links, and source URLs.

start_kol_searchWrite / Research (mcp:search)

Starts an asynchronous, evidence-verified discovery search (default 5 candidates, max 25). Automatically routes standalone prompts to Quick Searches when projectId is omitted.

get_search_statusRead-only (mcp:read)

Polls progress for a running searchId, surfaces any clarification question, and returns ranked candidates with citations once complete.

answer_search_clarificationWrite / Research (mcp:search)

Submits your clarification answer when a search pauses in awaiting_clarification state so verification can resume.

cancel_kol_searchWrite / Destructive (mcp:search)

Cancels an active discovery search in the authorized workspace.

Example prompts

  • List my active KOL Luminary projects.
  • Search my KOL Luminary library for breast cancer experts.
  • Open the full profile and citations for the first matching KOL.
  • Find 5 leading thoracic oncology KOLs in Germany.
  • Check the status of my KOL search.