MCP tools reference
These are the tools your AI assistant can use once it is connected to an Ansehn project. You don't call them yourself: ask a question in plain language and the assistant picks the right tools. Every tool works on the connected project only.
All tools read data, except updateContentActionStatus, which your assistant can use only if you allowed Update content action status when you connected it, or if its API key has the Content Actions Write scope. Your assistant lists exactly the tools available to it, so the list below can be longer than what you see.
Setup
Tool | What it gives your assistant |
|---|---|
| Finds personas, competitors, monitors and prompts by name, and suggests close matches for misspellings |
| Brand, domain, country, and how many monitors, prompts, competitors and personas you track |
| Your monitors and their status |
| Your buyer personas with conversion potential and key pain point |
| Your tracked prompts, filterable by country, monitor, type, intent or persona |
Prompts and AI answers
Tool | What it gives your assistant |
|---|---|
| The recorded AI answers for one prompt, with brand mentions, citation share and sentiment |
| One prompt's runs, mention rate and results per AI model over time |
Scores and competitors
Tool | What it gives your assistant |
|---|---|
| Current visibility, share of voice, position, citation share and sentiment |
| The daily trend of those scores |
| Your scores next to your tracked competitors' |
| Your brand's sentiment score, when sentiment is enabled for the project |
Citations
Tool | What it gives your assistant |
|---|---|
| Total citations, top citing domains, and the split between your domain, competitors and third parties |
| The prompts and AI providers where a given domain was cited |
| The most cited URLs with their owner type |
| Which prompts and AI models cited one URL |
Buying simulations
Tool | What it gives your assistant |
|---|---|
| Your win rate, filterable by persona, country or date |
| Recent completed simulations, newest first |
| One simulation's winner, persona, location, transcript excerpts and report |
| The outcome of a run, win-rate context and the competitors that won |
| The full run history of one simulation schedule |
| Schedules found by persona, question, AI engine or country |
| Two AI engines compared: win rates, content gaps and recommendations |
| Content gaps and recommendations combined across simulation reports |
Buying simulation cockpit
These tools need a project on the current buying-simulation version.
Tool | What it gives your assistant |
|---|---|
| How often your brand appears in buying conversations |
| Your share of vendor mentions compared with competitors |
| Your win rate per AI assistant |
| The domains AI assistants cite in buying conversations |
| The trend of presence, recommendations and win rate |
| The strongest recent answer where your brand won |
Content and pages
Tool | What it gives your assistant |
|---|---|
| Your content actions by priority, as on the Content Actions page |
| Sets one content action to open, in progress, in review, done or archived (needs write access) |
| Pages you published or changed, newest first |
| Your own pages, with AI citations and AI crawler visits |
| How many of your pages AI cited or visited, over up to 90 days |
Server logs
Tool | What it gives your assistant |
|---|---|
| AI crawler traffic from your uploaded server logs |
What the tools can't do
No tool can edit personas, prompts, monitors, competitors or buying-simulation schedules, start simulations, spend credits or send Slack or Teams messages. Those changes happen in Copilot inside Ansehn, after you confirm them. For the scopes behind each tool, see the Capability reference.