Connect KOLens to Claude
Paste one URL into Claude.ai's Custom Connector dialog, click Approve once, and Claude can search KOLs, pull audience snapshots, spy on ads, manage your watchlist and alerts — all in plain English. Uses MCP + OAuth 2.1 with PKCE; your credentials never leave kolens.ai.
https://kolens.ai/mcpThe exact URL to paste into Claude.
Setup in 30 seconds
- 1
Open Claude.ai and go to Settings → Connectors.
Available on Claude Pro, Team, and Enterprise. Look for Add custom connector at the bottom of the connector list.
- 2
Paste
https://kolens.ai/mcpand click Connect.Claude auto-discovers our OAuth endpoints (RFC 9728/8414) and dynamically registers itself as a public client (RFC 7591). You don't need to create an API key or fiddle with secrets.
- 3
Log into your KOLens account on the consent page.
You'll be redirected to
https://kolens.ai/oauth/authorize. Don't have an account? Create one first. - 4
Review the requested scopes and click Approve.
The consent page lists exactly what Claude is asking for — typically
read:kols,write:lists,run:scrape. You can revoke any of these from Account → Connections at any time. - 5
Done — try a query.
Open any Claude conversation and ask one of:
- “Search for phone case KOLs with over 50k followers in the US.”
- “Get the audience snapshot for @creatorbeta.”
- “Add @creatoralpha to my A-list watchlist.”
- “Mark all my rising_kol alerts as read.”
15 tools, instantly
Discovery
list_kols— Filter KOLs by keyword, follower count, engagement, region.get_kol_profile— Full profile + recent videos + contact info.search_history— What you (or your team) searched recently.run_scrape— Kick off a new keyword scrape job.
Audience & growth
get_audience_snapshot— Country mix, language, activity %, top niches, with 95% CI.list_alerts— Rising KOLs + trending videos KOLens flagged for you.mark_alert_read— Dismiss an alert from chat.
Ad spy
list_advertisers— Brands currently running Facebook Ads in a niche.get_ad_detail— Pull a single ad's full payload — copy, creative, run dates.list_watches— Auto-running ad-spy watches you've saved.
Lists & watchlist
add_to_list— Save a KOL into a named list for export later.add_to_watchlist— Track a KOL's growth over time.list_lists— Your KOL lists.list_watchlist— Your tracked KOLs + change deltas.remove_from_watchlist— Stop tracking a KOL.
Security
- OAuth 2.1 + PKCE. Your password never leaves kolens.ai. Claude exchanges an authorization code for an opaque, revocable access token.
- Granular scopes. Each tool maps to a scope you explicitly approve. The consent screen lists them by name — no hidden access.
- Revocable per-app. Visit /account/connections to see every connected client and revoke any token in one click (RFC 7009).
- No long-lived secrets to copy. Tokens auto-expire and refresh. Custom Connector URLs are safe to share within your org.
Troubleshooting
I don't see “Add custom connector” in Claude.ai.
Custom Connectors require a paid Claude plan (Pro, Team, or Enterprise). On the Free tier, the option is hidden. Upgrade at claude.ai/upgrade.
The consent page says “Invalid client”.
Claude registers a fresh client every time you add the connector. If you tried earlier and the registration was interrupted (closed the tab, etc.), remove the half-added connector from Claude.ai → Settings → Connectors and re-add it. Each registration is single-use.
Claude says it can't see KOLens tools after I connected.
Refresh the Claude conversation, or start a new one — Claude only refreshes its tool list at conversation boundaries. If tools still don't appear, check /account/connections to verify the connection is active.
The URL https://kolens.ai/mcp 404s when I visit it directly.
Expected. /mcp only responds to POST with a JSON-RPC body — there's nothing to render in a browser. Claude posts to it under the hood. To confirm the endpoint is alive, hit https://kolens.ai/.well-known/oauth-authorization-server in a new tab — you should see a JSON document.
Manage and revoke connected Claude clients in Account → Connections.