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 proposeCreatePersona and proposeCreateSchedule, which need Propose personas and schedules (see Set up personas and buying simulations). 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 |
| Files a proposal for a new persona, which you confirm on the Setup proposals page |
| Files a proposal for a new buying-simulation schedule for an existing persona, with its credit estimate, which you confirm on the Setup proposals page |
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 gaps and Content Rules
Tool | What it gives your assistant |
|---|---|
| The content gaps found for your company grouped by product area and topic, with priority, status, AI engines and when each was last seen |
| One gap in full: your Content Rules, the problem, the winning competitors and their pages, where competitors do better, the actions to take, and the buyer questions and AI answers behind it |
| Your Active Content Rules, which the assistant follows when it writes content. See Use your Content Rules |
Content and pages
Tool | What it gives your assistant |
|---|---|
| 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 |
No tool can change your existing setup, start simulations or spend credits. See Security and data handling for the full list of limits, and the Capability reference for the API key scopes behind each tool.