Every tool the Gensiv MCP server offers, what it returns and the API endpoint it mirrors.
Every tool except brands_list takes a brandId. Start with brands_list, then pass a brand id to the others. Lists return at most 25 items a page; use page for more. Each tool returns the same data as the API endpoint in the last column, and filters take the same values, such as engine slugs from brand_engines and dates as YYYY-MM-DD in UTC.
| Tool | What it returns | API endpoint |
|---|---|---|
brands_list | Your brands grouped by workspace, with id, name and domain | GET /brands |
brand_hub_get | The brand hub: description, key features, industry, tone of voice and persona | GET /brands/{brandId}/hub |
brand_engines | The AI engines tracked for the brand, with the slugs other tools filter by | GET /brands/{brandId}/engines |
usage_get | Plan, limits and usage for brands, prompts, responses, site pages and credits | GET /billing/usage |
| Tool | What it returns | API endpoint |
|---|---|---|
visibility_overview | Visibility, share of voice, position and mentions for the brand and each competitor, by day | GET /brands/{brandId}/dashboard/overview |
visibility_heatmap | One metric in a grid of brands, engines, topics or countries | GET /brands/{brandId}/dashboard/heatmap |
visibility_countries | Visibility per country of the tracked prompts | GET /brands/{brandId}/dashboard/countries |
trends_movers | Prompts where the brand's visibility rose or fell most | GET /brands/{brandId}/trends/movers |
sentiment_overview | Average sentiment of AI answers about the brand, by prompt type and day | GET /brands/{brandId}/sentiment/overview |
competitors_list | Tracked competitors with ids, domains and tags | GET /brands/{brandId}/competitors |
| Tool | What it returns | API endpoint |
|---|---|---|
prompts_list | Tracked prompts with type, intent, country, topics, tags and visibility | GET /brands/{brandId}/prompts |
prompt_insights | One prompt's ranking of the brand and competitors, with daily results | GET /brands/{brandId}/prompts/{promptId}/insights |
responses_list | AI answers with a preview, scores, brand mentions and citation counts | GET /brands/{brandId}/responses |
response_get | One AI answer in full, with every mention and cited URL | GET /brands/{brandId}/responses/{responseId} |
responses_overview | Answer counts by engine and day | GET /brands/{brandId}/responses/overview |
topics_list | Topics with ids and prompt counts | GET /brands/{brandId}/topics |
tags_list | Prompt or competitor tags with ids | GET /brands/{brandId}/tags |
personas_list | Buyer personas and their persona prompts | GET /brands/{brandId}/personas |
| Tool | What it returns | API endpoint |
|---|---|---|
citation_domains | Domains AI engines cite most, and whether each is yours, a competitor's or other | GET /brands/{brandId}/citations/domains |
citation_urls | Cited pages with title, source type, content type and counts | GET /brands/{brandId}/citations/urls |
citation_url_get | One cited page: the prompts and engines that cite it and the brands it mentions | GET /brands/{brandId}/citations/urls/{pageId} |
reddit_threads | Reddit threads AI engines cite, with subreddit and brand mentions | GET /brands/{brandId}/social/reddit/posts |
fanout_queries | Web searches AI engines ran while answering, with counts per engine | GET /brands/{brandId}/fanouts/queries |
| Tool | What it returns | API endpoint |
|---|---|---|
content_gaps_overview | How well the brand's site covers what AI answers discuss | GET /brands/{brandId}/content-gaps/overview |
content_gap_prompts | Prompts with the site's coverage score for each | GET /brands/{brandId}/content-gaps/prompts |
content_gap_get | One prompt's gap: score, the searches engines ran and a recommendation | GET /brands/{brandId}/content-gaps/prompts/{promptId} |
actions_list | Action items with kind, severity, status and assignee | GET /brands/{brandId}/actions |
action_get | One action item with its details and activity | GET /brands/{brandId}/actions/{actionId} |
documents_list | Articles and page refreshes Gensiv wrote, with status and published URL | GET /brands/{brandId}/documents |
document_get | One article with its brief, findings, SEO fields and full Markdown | GET /brands/{brandId}/documents/{documentId} |
These appear only on connections that allow changes (Setup). Clients that read tool annotations ask before running the tools marked destructive.
| Tool | What it does | Destructive | API endpoint |
|---|---|---|---|
prompts_create | Adds tracked prompts; counts toward the plan's prompt limit | No | POST /brands/{brandId}/prompts |
prompts_update | Edits one prompt's text, type, intent, country, topics or tags | No | PATCH /brands/{brandId}/prompts/{promptId} |
prompts_bulk | Enables, disables, classifies, relocates or deletes several prompts | Yes | POST /brands/{brandId}/prompts/bulk |
prompts_tag | Adds tags to, or removes them from, several prompts | No | POST /brands/{brandId}/prompts/tags |
prompts_set_topics | Adds several prompts to topics, or removes them | No | POST /brands/{brandId}/prompts/topics |
competitors_create | Tracks a new competitor as direct or ignored | No | POST /brands/{brandId}/competitors |
competitors_update | Edits a competitor's name, website and variations | No | PATCH /brands/{brandId}/competitors/{competitorId} |
competitors_bulk | Moves several competitors to direct, ignored or suggested, or deletes them | Yes | POST /brands/{brandId}/competitors/bulk |
competitors_tag | Adds tags to, or removes them from, several competitors | No | POST /brands/{brandId}/competitors/tags |
topics_create | Adds a topic | No | POST /brands/{brandId}/topics |
topics_update | Renames or recolors a topic | No | PATCH /brands/{brandId}/topics/{topicId} |
topics_delete | Deletes a topic; its prompts stay | Yes | DELETE /brands/{brandId}/topics/{topicId} |
tags_create | Adds a prompt or competitor tag | No | POST /brands/{brandId}/tags |
tags_rename | Renames a tag | No | PATCH /brands/{brandId}/tags/{tagId} |
tags_delete | Deletes a tag and removes it from everything it labels | Yes | DELETE /brands/{brandId}/tags/{tagId} |
personas_create | Adds a buyer persona | No | POST /brands/{brandId}/personas |
personas_update | Replaces a buyer persona's fields | No | PUT /brands/{brandId}/personas/{personaId} |
personas_delete | Deletes a buyer persona | Yes | DELETE /brands/{brandId}/personas/{personaId} |
actions_create | Adds a custom action in To Do | No | POST /brands/{brandId}/actions |
actions_update | Moves an action on the board or changes its severity, assignee or text | No | PATCH /brands/{brandId}/actions/{actionId} |
documents_create | Starts writing an article in the background; spends writing credits | No | POST /brands/{brandId}/documents |
documents_refresh | Starts rewriting an existing page in the background; spends writing credits | No | POST /brands/{brandId}/documents/refresh |
Writes follow the same plan limits as the app. When a workspace is out of credits or over a limit, the tool returns the reason and the plan that fixes it.
Tool errors come back as a normal tool result the assistant can read and explain:
| Message | Why | Fix |
|---|---|---|
| Brand not found | The brand id is wrong or belongs to a workspace you're not in | Call brands_list and use an id from it |
| The API and MCP start on Starter | The workspace is on Lite | Upgrade in Settings > Billing |
| Pick a plan to continue | The workspace has no active plan | Start a trial or pick a plan |
| This connection is read-only | A write tool was called on a connection without changes allowed | Reconnect with Allow changes on, or use a key with Allow changes |
| Not enough credits | The article needs more writing credits than are left | Buy a credit pack in Settings > Billing |