The IndustryLens MCP server, end to end.
Two endpoints, 30 tools, 12 of them with no sign-up. Streamable HTTP, OAuth 2.1 or an API key, one published rate limit per tier, and a dated answer on every call. Setup walkthroughs per app live on /mcp; this page is the reference.
Endpoints
Both speak Streamable HTTP and are stateless: one server per request, no session to keep alive.
https://api.industry-lens.com/mcp/publicAuth: None
Serves: Published facts about publicly tracked companies, markets, reports and comparisons. Never a customer’s data or who tracks whom.
https://api.industry-lens.com/mcpAuth: OAuth 2.1 (PKCE S256, dynamic client registration) or Bearer API key
Serves: Every public tool plus your own tracked competitor set: battlecards, signals, recommendations, call prep, write-back.
Discovery, all unauthenticated, all under https://api.industry-lens.com:
/.well-known/mcp/server-card.jsonServer card (SEP-2127): name, version, both remotes, auth, public tool list. Alias /.well-known/mcp.json./.well-known/oauth-protected-resourceRFC 9728 protected-resource metadata for the account endpoint./.well-known/oauth-authorization-serverAuthorization server metadata: issuer, endpoints, S256, registration at /oauth/register.
Connect
No client needs a manual OAuth app. The server registers the client itself.
- Public tier. Point any MCP client at the public URL. No key, no account, no header.
- Account tier, OAuth. The client reads the protected-resource metadata, registers at
/oauth/register(dynamic client registration, PKCE S256 only), and sends you to connect.industry-lens.com to sign in with your work email and a 6-digit code, or a password if your account has one. Remembered consents skip the screen. Users with several accounts get a picker. - Account tier, API key. Create a key at connect.industry-lens.com/keys and send it as
Authorization: Bearer <key>. Revoking the key there also revokes OAuth connections for that user. - Unsigned requests to the account URL get
401withWWW-Authenticate: Bearer realm="industrylens-mcp", which is what lets clients start the flow on their own.
Step-by-step for each app:
Any other MCP-aware tool that accepts a remote server URL works the same way.
Tools
30 tools: 12 on the public tier, 18 more with an account. Every tool carries MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint). Call tools/list after connecting for your live set: some accounts see extra entitlement-gated tools.
find_competitorsMonitorFreeWho competes with a given company, across the markets we monitor.
list_competitor_movesMonitorFreeThe latest tracked moves for a single competitor, newest first.
get_competitor_moves_diffMonitorFreeA dated was→now change feed for a competitor: every strategic move on a timeline, stamped with its real analysis date. Batch mode: pass up to 10 competitors in one call.
get_pricing_changesMonitorFreeStructured pricing changes: change type, severity, a plain-language summary, and the detection date. Batch mode: pass up to 10 competitors in one call.
list_marketsMonitorFreeThe whole-category map for a market we track: the published overview plus every player in it.
get_market_landscapeMonitorFreeThe whole-category map for a market we track: the published overview plus every player in it.
list_signalsMonitorAccountThe verified, scored insights behind your weekly briefing, newest first.
get_hiring_by_geoMonitorAccountWhere a competitor is hiring, broken down by geography. Filter by region code or a plain name (North America, Europe, UK, Benelux, APAC, LATAM).
get_my_marketMonitorAccountThe landscape digest for your own tracked set, not just one competitor, or a focused section view (overview, partners, integrations, hiring, end-of-life).
get_competitive_profileAnalyseFreeOne company in, a competitive overview out: firmographics, recent strategic moves, and the reports that cover them (funding stage, last raise and investors are on the way). Batch mode: pass up to 10 companies in one call.
compare_competitorsAnalyseAccountTwo competitors, side by side, across the dimensions that matter for a deal.
get_customer_voiceAnalyseAccountWhat customers and reviewers say: ratings across six platforms (G2, Capterra, Gartner Peer Insights, TrustRadius, Apple App Store, Google Play), price complaints, requested features, and who switched from whom. get_review_complaints and compare_review_ratings still work as aliases for this release.
get_review_complaintsAnalyseAccountWhat customers and reviewers say: ratings across six platforms (G2, Capterra, Gartner Peer Insights, TrustRadius, Apple App Store, Google Play), price complaints, requested features, and who switched from whom. get_review_complaints and compare_review_ratings still work as aliases for this release.
compare_review_ratingsAnalyseAccountWhat customers and reviewers say: ratings across six platforms (G2, Capterra, Gartner Peer Insights, TrustRadius, Apple App Store, Google Play), price complaints, requested features, and who switched from whom. get_review_complaints and compare_review_ratings still work as aliases for this release.
compare_capabilitiesAnalyseAccountHow you compare to one competitor, or your whole tracked market, on specific product capabilities, filterable to AI-only. Labels whether a data point is IndustryLens’s own evidence or your team’s own supplied data.
list_ai_movesAnalyseAccountTracked AI-feature moves across your competitor set, graded on the same source your dashboard uses: a real release stage (ga, beta, announced, partner, removed) and an honest event date, not just a detection date.
get_recommendationsAnalyseAccountThis week’s strategic recommendations, with the reasoning behind each.
ask_industrylensAnalyseAccountAn open question about your tracked competitors, answered from your account’s live data.
get_market_visibilityAnalyseAccountSEO and AI-search visibility, plus estimated organic traffic, for a competitor’s domain.
get_tech_stackAnalyseAccountThe technology stack a competitor runs on: CMS, analytics, CDN, ad tech and more.
get_battlecardSellAccountThe current battlecard for a competitor, section by section.
prep_for_callSellAccountA pre-call brief for a named competitor: what changed (AI moves flagged first), pricing detail (tiers, whether AI is included or a paid add-on, billing cadence), review benchmark and what to say. Any section that failed to load is flagged unavailable, never shown as empty.
list_competitorsSellAccountEvery company on your account’s tracked list.
suggest_intelWrite backAccountSubmit human-reviewed intel you’ve picked up elsewhere, for it to be verified and folded into your account.
annotate_battlecardWrite backAccountAdd a reviewed note to a specific battlecard section for a tracked competitor, straight from your AI assistant. Human-reviewed before it ever appears: never auto-published.
list_reportsCatalog & push notificationsFreeBrowse and read IndustryLens’s published intelligence reports.
get_reportCatalog & push notificationsFreeBrowse and read IndustryLens’s published intelligence reports.
list_comparisonsCatalog & push notificationsFreeBrowse and read head-to-head competitor comparisons.
get_comparisonCatalog & push notificationsFreeBrowse and read head-to-head competitor comparisons.
subscribe_to_newsletterCatalog & push notificationsFreeSign up for weekly briefings, with explicit consent.
Write tools (suggest_intel, annotate_battlecard) create items in a human review queue and never auto-publish. They need the owner or admin role; any other credential gets a clear rejection. No tool edits or deletes existing data.
Prompts and resources
Prompts show up in Claude as ready-made commands. Resources are documents an agent reads directly; account resources support resources/subscribe, so the client is notified on change instead of polling.
market_briefpromptFreeA dated, cited competitive brief for one company (profile plus moves feed).
compare_twopromptFreeHead-to-head of two companies, preferring a published comparison, else each profile.
competitor_this_monthpromptFreeWhat one company changed in the last 30 days, dated.
pricing_changespromptFreeRecent pricing or packaging changes for one company or across a market.
who_competespromptFreeWho else competes with a company and how each peer differs.
call_preppromptAccountSales-call brief for one tracked competitor from the battlecard, signals and recommendations.
weekly_actionpromptAccountThis week’s recommendations with the evidence behind each.
industrylens://reportsresourceFreeThe list of published reports.
industrylens://reports/{slug}resourceFreeOne published report, full body.
industrylens://signals/latestresourceAccountLatest verified signals for your account. Supports resources/subscribe for push.
industrylens://battlecards/{competitorId}resourceAccountA tracked battlecard. Supports resources/subscribe: your client is notified when it changes.
What a response looks like
- Provenance on every answer. A
provenanceblock with provider, tool,generated_atanddata_as_of, so the agent can say how fresh the data is. - Dated items. Moves, pricing changes and signals carry their real analysis or detection date, never a fabricated one.
- Not covered is a value, not an error. A company we do not publicly track returns
covered: false. On the account tier, a company outside your tracked set is answered from public data, labelled as such, with a note on how an owner or admin can add it. - Account answers are evidence-first. Battlecard, compare and ask tools return
evidence[](approved, dated insights with verification URLs),grounding(counts, recency, trust breakdown, sourcing),whats_newand signal-firstsections. Sections with nothing new are listed inquiet_sectionsrather than padded. - Links back to the site carry
utm_source=mcpand the tool name. Competitor and source URLs are never changed.
A real public call and its JSON is shown on /features/api; live weekly answers are on /mcp/examples.
Limits and freshness
One number per tier, published. Need more? Ask.
30 requests per minute, per caller IP.
120 requests per minute, per credential (OAuth connection or API key).
50 submissions per 24 hours, per account, across suggest_intel and annotate_battlecard.
up to 10 companies per call, get_competitive_profile, get_pricing_changes, get_competitor_moves_diff.
Refreshed weekly. Each item carries its own analysis date.
Live lookup, cached 7 days per domain.
Live lookup, cached 30 days per domain.
Published on their own schedule; the resource list is live.
No live web search inside the tools: answers come from the checked IndustryLens record, which is what makes them citable. Coverage refreshes weekly; a quiet week is reported as quiet.
For admins
- Keys. Issued and revoked per user at connect.industry-lens.com/keys. Revocation covers that user's OAuth connections too.
- Roles. Owner and admin can use the two write-back tools. Member and sales roles are read-only on the same tools list.
- Sign-in. Existing users only; the MCP flow never creates accounts in your workspace. Each person connects with their own sign-in, so usage is attributable per user. There is no shared service account.
- Scope. The account endpoint only returns your own tracked set. The public endpoint never returns any customer's data or who tracks whom.
What we log
- Per call: time, tier, tool name, duration, success or error, the connecting app name and version, and the tool arguments with values capped at 200 characters and email addresses redacted.
- Never: the conversation. The server only receives the tool call, not the chat around it.
- Public-tier calls are keyed by a hash of the caller IP for rate limiting, not stored raw.
- Details in the privacy policy, section 10 (MCP connector).
Changelog
Site: /mcp gained a "What you can delegate" section and this developer page.
Public MCP fixes shipped (#52); /mcp/examples now shows live weekly answers from the public server.
Account tier: get_customer_reference_watch, get_coordinated_moves, get_self_position and get_adoption_benchmarks added (entitlement-gated).
Tool annotations on every tool; server card; client attribution; untracked companies answered from public data with a labelled note; UTM tags on result links; email-code and password sign-in on connect.
Write-back tools restricted to owner and admin roles.
MCP review phase 2: batch queries on three public tools; 30 tools total.
Registry name com.industry-lens/mcp-public. Manifests and the server card source are in industrylens-mcp-docs on GitHub. Site-wide changes are on /changelog.
Try it without signing up
Add the public URL to your client and ask "What did Apollo.io change this month?". An account unlocks the other 18 tools from £149/month.