Integrations

Connect AI assistants to Searchestra (MCP)

Searchestra has a remote Model Context Protocol (MCP) server. Connect it to Claude, or to any other MCP client, and ask about your AI visibility in plain language: the assistant reads your brands, markets, Prompt Universes, AI answers, citations, sentiment and Action Center data, with exactly the access you have in Searchestra.

MCPhttps://panel.searchestra.com/mcp

Add to Claude → Opens Claude with the name and URL filled in. You review them before anything is added.

Overview

Transport: Streamable HTTP, at one URL for every organization.
Sign-in: OAuth 2.1 with PKCE. Each person signs in with their own Searchestra account and approves the connection; nobody shares an API key.
Access: the assistant sees only the brands, markets and Prompt Universes you can see, and can change data only where your role allows it.
Tools: 43 tools: 36 read data and 7 change it. See the tool reference.

Before you start

A Searchestra account in an organization whose plan includes API access. Tools for citations, sentiment and the Action Center return data only when those modules are in your plan.
AI assistant connections allowed for your organization. They are on by default; an owner can turn them off in Settings > Security > AI assistants.
At least one Prompt Universe with collected answers, so the tools have data to return.
If your organization limits access by IP address, allow Anthropic's outbound range 160.79.104.0/21 for Claude on the web, desktop and mobile. Claude Code connects from your own computer.

Connect Claude

Searchestra works in Claude on the web, the desktop and mobile apps, and Cowork as a custom connector. The fastest way is the Add to Claude link, which fills in the name and URL for you.

Pro and Max plans

In Claude, open Customize > Connectors and select Add custom connector.
Enter the name Searchestra and the URL https://panel.searchestra.com/mcp. Leave the OAuth client ID and secret empty; Claude identifies itself automatically.
Select Add, then Connect. Sign in to Searchestra if asked.
On the Searchestra screen, check that access goes to claude.ai, review what the assistant can do and select Allow access.

Team and Enterprise plans

A Claude organization Owner opens Organization settings > Connectors, selects Add, then Custom (choose Web if asked) and enters the same name and URL.
Each member then finds Searchestra under Customize > Connectors with the Custom label and selects Connect to sign in with their own Searchestra account.

Use it in a chat

Turn the connector on for a conversation from + > Connectors, then ask your question. Claude asks before it runs a tool that changes data.

Claude Code

Add the server from a terminal, then sign in from inside Claude Code:

Terminal

claude mcp add --transport http searchestra https://panel.searchestra.com/mcp

Start Claude Code, run /mcp, choose searchestra and authenticate. Your browser opens the Searchestra approval screen; access goes back to localhost on your computer.

Other MCP clients

Any MCP client that supports Streamable HTTP and OAuth works with the same URL. The server publishes standard discovery documents, so clients can find the sign-in flow on their own:

Protected resource metadata: https://panel.searchestra.com/.well-known/oauth-protected-resource/mcp
Authorization server metadata: https://panel.searchestra.com/.well-known/oauth-authorization-server
Client registration: Client ID Metadata Documents or Dynamic Client Registration. Public clients with PKCE (S256); https redirect URIs, or loopback addresses on any port for desktop apps.
Scopes: mcp:read to read data, mcp:write to also change it.

Example prompts

Ask in your own words. The assistant finds your brand, market and Prompt Universe first, then calls the right tools.

“Summarize our AI visibility, citations and sentiment in our main market for the last 30 days, and point out what changed.”
Uses the discovery tools, then the KPI summary and reports.
“Which prompts in our Prompt Universe is our brand missing from, and which competitors appear instead?”
Uses brand gap opportunities and the answers for those prompts.
“Which high-authority pages cite our competitors but not us? Group them by domain and suggest where to start.”
Uses citation opportunities and the cited domains.
“How do the AI platforms differ in how they describe our brand? Show the sentiment by platform and the main themes.”
Uses sentiment by platform and sentiment themes.
“Add these three prompts to our Prompt Universe: ‘best budget option for beginners’, ‘alternatives to the market leader’, ‘is it worth upgrading this year’.”
Changes data, so Claude asks you to approve the call first.

Tip. If you have several brands or markets, name the one you mean, for example “in our Germany market”. Otherwise the assistant asks or lists them first.

Permissions and safety

Your role, nothing more: every call is checked against your current role, the same way the Searchestra app checks it. Viewers can only read. Changing prompts, topics and tags needs a role that can configure the Prompt Universe, such as Editor or Brand admin.
Read and write access: the approval screen shows whether the assistant asked to change data. Tools that change data need mcp:write.
Confirmation for every change: the seven tools that change data are marked as destructive, so Claude asks you before each call. Read-only tools can run without a prompt.
Plans never change data: execute_plan runs read-only tools only. A step that would change data is refused and must be called on its own.
Checked on every use: your organization's membership, single sign-on, multi-factor and network policies apply each time the assistant calls Searchestra, not only when you connect. Access tokens last 30 minutes and renew automatically; a connection lasts at most 90 days, then you connect again.

Data and privacy

Searchestra receives only the tool requests the assistant sends. It does not receive or store your conversation with the assistant.
The data a tool returns is sent to the assistant you connected and is then handled under that provider's terms. For Claude, see Anthropic's privacy policy.
Searchestra records each connection with who connected it, when it was created and when it was last used, so owners can review and disconnect it.
Do not submit special-category or highly sensitive personal information unless your organization has an expressly approved processing arrangement with Searchestra.

How we process personal data is described in the Privacy Notice.

Tool reference

Every tool has a short title, shown in your assistant, and a name used in the protocol. Most tools need a market or Prompt Universe ID, which the discovery tools return.

Discovery

Tool	What it does	Scope
List brands `list_brands`	Lists the brands in the organization that the user can access. Brand IDs lead to the market and Prompt Universe IDs that the other tools need.	Organization
List markets `list_markets`	Lists the markets (country and language) of one brand, or of all brands. Returns the market_id that market-scoped tools need.	Organization
List Prompt Universes `list_universes`	Lists the Prompt Universes in a market. Returns the universe_id that the prompt, topic and tag tools need.	Market
List AI models `get_all_models`	Lists the tracked AI models (platforms).	Organization

Prompt Universe content and answers

Tool	What it does	Scope
List prompts `get_all_prompts`	Lists the tracked prompts in a Prompt Universe.	Prompt Universe
List keywords `get_all_keywords`	Lists the text of the tracked prompts in a Prompt Universe.	Prompt Universe
List topics `get_all_topics`	Lists the topics in a Prompt Universe.	Prompt Universe
List tags `get_all_tags`	Lists the tags in a Prompt Universe.	Prompt Universe
Prompt answers `get_prompt_answers`	Returns the AI answers collected for a prompt.	Prompt Universe
Prompt result details `get_prompt_result_details`	Returns detailed AI answers for a prompt, optionally on one AI platform.	Prompt Universe
List AI answers `get_all_ai_answers`	Lists all AI answers collected in a Prompt Universe.	Prompt Universe

Performance and KPIs

Tool	What it does	Scope
KPI summary `get_kpi_summary`	Summarizes the main market KPIs (visibility, citations, sentiment) in one call.	Market
Performance report `query_performance_report`	Returns visibility and citation performance for a market, or one Prompt Universe, computed from collected AI answers.	Market

Citations and sources

Tool	What it does	Scope
Citation report `query_citation_report`	Returns the citation summary: total citations, the brand's share and unique domains.	Market
List citations `get_all_citations`	Lists the citations in AI answers for a market.	Market
Market citations `get_prompt_citations`	Returns the citations in AI answers for a market.	Market
List cited domains `get_all_domains`	Lists cited domains and their share of citations.	Market
Cited pages of a domain `get_domain_pages_cited`	Lists the pages of a domain that are cited in AI answers.	Market
Platforms citing a domain `get_domain_citation_platforms`	Returns which AI platforms cite a domain.	Market
Most cited pages `get_industry_cited_pages`	Lists the most cited pages in the market, including the brand's own pages.	Market
Citation opportunities `get_citation_opportunities`	Lists high-authority pages that cite competitors but not the brand.	Market
External mentions `get_external_mentions`	Lists mentions of the brand on third-party and social sources.	Market

Sentiment

Tool	What it does	Scope
Sentiment report `query_sentiment_report`	Returns the sentiment report: score and distribution.	Market
Sentiment by platform `get_sentiment_by_platform`	Breaks down the sentiment score by AI platform.	Market
Sentiment by competitor `get_sentiment_by_competitor`	Breaks down the sentiment score by competitor.	Market
Sentiment themes `get_sentiment_themes`	Lists sentiment themes, the topics that drive how the brand is perceived.	Market
Sentiment theme keywords `get_sentiment_keywords`	Lists the keywords under a sentiment theme.	Market

Action Center and Prompt Explorer

Tool	What it does	Scope
Action Center summary `get_actionables_dashboard`	Returns the Action Center summary for a market: total actions, open actions and potential visibility gain.	Market
Brand gap opportunities `get_all_brand_gap_opportunities`	Lists prompts where the brand does not appear in AI answers, as new content opportunities.	Market
New content opportunities `get_all_new_content_opportunities`	Lists recommended new content opportunities.	Market
Optimization opportunities `get_all_optimization_opportunities`	Lists improvement opportunities for existing pages.	Market
Broken pages `get_all_broken_pages`	Lists pages that returned errors to AI crawlers.	Market
Action details `get_action_info`	Returns the details of one action, including sample answers and related mentions.	Market
Prompt Explorer overview `get_prompt_explorer_overview`	Returns Prompt Explorer prompts with search volume, difficulty and intent.	Market

Planning

Tool	What it does	Scope
Plan tools for a question `tools_info`	Turns a natural-language question into a suggested list of Searchestra tools to run, with the reason for the plan. It does not run any tools.	None
Run a read-only tool plan `execute_plan`	Runs a list of read-only Searchestra tools in order and returns all results in one response. market_id and universe_id are passed to every step. Steps that would change data are refused.	None

Tools that change data

Tool	What it does	Scope
Create prompt `create_prompt`	Adds a new tracked prompt to a Prompt Universe.	Prompt Universe
Delete prompts `bulk_delete_prompts`	Deletes several prompts in one call.	Prompt Universe
Create topic `create_topic`	Adds a new topic to a Prompt Universe.	Prompt Universe
Archive topic `delete_topic`	Archives a topic in a Prompt Universe.	Prompt Universe
Create tag `create_tag`	Adds a new tag to a Prompt Universe.	Prompt Universe
Delete tag `delete_tag`	Deletes a tag from a Prompt Universe.	Prompt Universe
Generate optimization fix plan `get_optimization_fixes`	Generates step-by-step fix suggestions for an action and saves them on the action, replacing any previously saved suggestions.	Market

List tools return up to 25 items per page by default. Date ranges use start_date and end_date in YYYY-MM-DD format.

Manage connections

Your connections: in Searchestra, open Settings > Profile. Connected AI assistants lists every assistant you connected, when it was last used, and a Disconnect button.
Your organization: owners open Settings > Security > AI assistants to see every connection, disconnect any of them, or turn AI assistant connections off for everyone. Turning them off disconnects all assistants immediately.
In Claude: remove or reconnect the connector under Customize > Connectors, and set any single tool to Blocked if you never want Claude to use it.

Troubleshooting

“Your organization's plan does not include …”

The connection needs API access, and some tools need the citations, sentiment or Action Center modules. Contact us to add them to your plan.

The approval screen says connections are turned off

An owner has turned off AI assistant connections. Ask them to turn on Allow members to connect AI assistants in Settings > Security > AI assistants.

Calls fail after a while, or Claude shows Reconnect

The connection expired after 90 days, was disconnected, or your sign-in policy changed, for example a new multi-factor requirement. Select Reconnect and approve again.

Access is denied from Claude but works in Searchestra

Your organization probably limits access by IP address. Allow 160.79.104.0/21, Anthropic's outbound range.

A tool returns no data

The Prompt Universe may have no collected answers for the period yet, or you may not have access to that brand. Run a scan in Searchestra, or ask the assistant to list the brands and markets you can see.

Still stuck? Write to team@searchestra.com. Report security issues to security@searchestra.com.