Skip to content

Howseen

by howseen.ai · remote · no sign-in to list tools · v1.0.0 · published by ai.howseen

How ChatGPT, Gemini, Perplexity and Google AI name your brand, cite sources and rank rivals.

Deletes · 5Final · 1Changes · 10

29 tools: 5 can delete or cancel things, 1 do something that can't be undone, 10 change things and 13 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http howseen https://app.howseen.ai/api/mcp --header 'Authorization: <your-authorization>'

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

29 tools

Deletes or cancels 5Claude Code: deny
  • archive_promptsArchive prompts: they stop being scanned (frees prompt quota) but keep their history and stay listed as archived in the dashboard, restorable.No findings

    Why it is in this group

    • The name "archive_prompts" says "archive": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Archive prompts: they stop being scanned (frees prompt quota) but keep their history and stay listed as archived in the dashboard, restorable. Preview first; confirm: true applies.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: false
  • delete_articleMove an article (planned, draft or published) to the Trash, like the dashboard delete button: restorable with restore_article or in Howseen > Content > Trash, and its topic is not …No findings

    Why it is in this group

    • The name "delete_article" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Move an article (planned, draft or published) to the Trash, like the dashboard delete button: restorable with restore_article or in Howseen > Content > Trash, and its topic is not planned again. A post already live on the client's own CMS (WordPress, Shopify...) is NOT removed from the CMS: the preview says where it stays live. Always call WITHOUT confirm first and show the preview to the user; call again with confirm: true only after they approve.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: false
  • publish_articlePublish a written article (e.g.No findings

    Why it is in this group

    • The name "publish_article" says "publish": a word for a change that another call does not undo.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Publish a written article (e.g. a draft from draft_article) to the brand's connected CMS (WordPress, Shopify, Ghost, BigCommerce, webhook) or hosted blog, now, or schedule it for a later date (needs Autopilot ON). Goes live publicly. Preview first; confirm: true publishes and returns the URL.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
  • remove_competitorStop tracking a competitor (by name or domain).No findings

    Why it is in this group

    • The name "remove_competitor" says "remove": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Stop tracking a competitor (by name or domain). Past results keep it. Preview first; confirm: true applies.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: false
  • remove_promptsStop tracking prompts and remove them from the prompt list (past scan results stay in history).No findings

    Why it is in this group

    • The name "remove_prompts" says "remove": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Stop tracking prompts and remove them from the prompt list (past scan results stay in history). Prefer archive_prompts to keep them listed. Preview first; confirm: true applies.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: false
Can't be undone 1Claude Code: ask
  • create_share_reportCreate a public, frozen report link (visibility, competitors, top prompts, recommendations) with the account's agency branding, like the dashboard Share button.No findings

    Why it is in this group

    • The name "create_share_report" says "create": a word for a change.
    • The input addresses people (input.to): what it sends cannot be taken back.
    Description, as the server wrote it
    Create a public, frozen report link (visibility, competitors, top prompts, recommendations) with the account's agency branding, like the dashboard Share button. Preview first; confirm: true creates the link.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: false
Changes things 10Claude Code: ask
  • add_competitorTrack a competitor from a name or a website URL (resolved to name + domain like in Settings), within the competitor quota.No findings

    Why it is in this group

    • The name "add_competitor" says "add": a word for a change.
    Description, as the server wrote it
    Track a competitor from a name or a website URL (resolved to name + domain like in Settings), within the competitor quota. Preview first; confirm: true applies.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • add_promptsTrack new buyer questions (prompts) for the brand, checked against the plan's prompt quota (the whole list is refused if it would exceed it).No findings

    Why it is in this group

    • The name "add_prompts" says "add": a word for a change.
    Description, as the server wrote it
    Track new buyer questions (prompts) for the brand, checked against the plan's prompt quota (the whole list is refused if it would exceed it). An archived prompt added again is restored. Preview first; confirm: true applies.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: false
  • dismiss_actionDismiss an action-plan item the user does not want to do (moves it to Archived in the dashboard, out of the next best actions).No findings

    Why it is in this group

    • The name "dismiss_action" says "dismiss": a word for a change.
    Description, as the server wrote it
    Dismiss an action-plan item the user does not want to do (moves it to Archived in the dashboard, out of the next best actions). Reversible in the dashboard. Preview first; confirm: true applies.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: false
    • idempotentHint: true
  • draft_articleWrite a DRAFT article answering one buyer question, with the same quality pipeline as the app (brand context, sources AI cites, GEO checks).No findings

    Why it is in this group

    • The description's first verb is "write": a word for a change.
    Description, as the server wrote it
    Write a DRAFT article answering one buyer question, with the same quality pipeline as the app (brand context, sources AI cites, GEO checks). Never publishes. Uses the plan's article allowance. Preview first; confirm: true writes it (up to about a minute).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • mark_action_doneMark an action-plan item as done (same state as the dashboard Action plan).No findings

    Why it is in this group

    • The name "mark_action_done" says "mark": a word for a change.
    Description, as the server wrote it
    Mark an action-plan item as done (same state as the dashboard Action plan). Use the action id from get_action_plan or get_easiest_wins. Preview first; confirm: true applies.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: false
    • idempotentHint: true
  • refresh_articleRewrite a WRITTEN article with the brand's current profile (offer, category, offerings, competitors) after it changed: same article id, slug, question and date, previous version ke…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Rewrite a WRITTEN article with the brand's current profile (offer, category, offerings, competitors) after it changed: same article id, slug, question and date, previous version kept (restorable in the app). A published article is never overwritten: the update lands in a refreshed draft. Free once per article after a profile change, otherwise uses the article allowance. Give article_id (list_articles) or the article's target question. Preview first (shows what changes and the quota impact); confirm: true rewrites it (up to about a minute).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • request_indexingSubmit a published article to the search engines connected for the brand: Google (sitemap re-submit through Search Console when connected with indexing), Bing (Webmaster key) or In…No findings

    Why it is in this group

    • The name "request_indexing" says "request": a word for a change.
    Description, as the server wrote it
    Submit a published article to the search engines connected for the brand: Google (sitemap re-submit through Search Console when connected with indexing), Bing (Webmaster key) or IndexNow for pages hosted by Howseen. If you publish on your own site from the API or feed, pass url (the live https address of the article on the brand's domain): Howseen records it and tracks indexing there. At most once per article every 24h. Preview first; confirm: true submits.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • restore_articleBring back an article from the Trash (e.g.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Bring back an article from the Trash (e.g. one deleted with delete_article). Preview first; confirm: true restores.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: false
    • idempotentHint: true
  • run_scanScan the brand's prompts on the AI engines now, with the same limit as the dashboard Run now button (a fresh scan at most once per brand per plan cadence: every 72h, every 24h on B…No findings

    Why it is in this group

    • The name "run_scan" says "run": a word for a change.
    Description, as the server wrote it
    Scan the brand's prompts on the AI engines now, with the same limit as the dashboard Run now button (a fresh scan at most once per brand per plan cadence: every 72h, every 24h on Business; prompts added since the last scan can be scanned alone; an unfinished scan can be continued). Preview first; confirm: true runs about 45 seconds per call.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • suggest_promptsBuyer questions worth tracking that the brand does not track yet: real questions from Hacker News discussions (ranked by engagement) plus AI suggestions for the category.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Buyer questions worth tracking that the brand does not track yet: real questions from Hacker News discussions (ranked by engagement) plus AI suggestions for the category. Returns suggestions only; use add_prompts to track some. Limited to 20 calls per day.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
Only reads 13Claude Code: allow
  • get_action_planPrioritized actions to raise the brand's AI visibility (off-page: get listed on the pages AI cites; content: answer uncovered buyer questions), ranked 20/80 like the dashboard Acti…No findings

    Why it is in this group

    • The name "get_action_plan" says "get": a word for reading.
    Description, as the server wrote it
    Prioritized actions to raise the brand's AI visibility (off-page: get listed on the pages AI cites; content: answer uncovered buyer questions), ranked 20/80 like the dashboard Action plan, with steps.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_article_performanceArticles written for the brand with status, GEO score, published URL and search-engine indexing status (Google URL Inspection, Bing), plus impressions and clicks when Search Consol…No findings

    Why it is in this group

    • The name "get_article_performance" says "get": a word for reading.
    Description, as the server wrote it
    Articles written for the brand with status, GEO score, published URL and search-engine indexing status (Google URL Inspection, Bing), plus impressions and clicks when Search Console or Bing is connected.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_changesWhat changed between the last two completed scans (or since a date): prompts gained and lost, visibility delta per engine, tracked competitors newly named, and the likely causes (s…No findings

    Why it is in this group

    • The name "get_changes" says "get": a word for reading.
    Description, as the server wrote it
    What changed between the last two completed scans (or since a date): prompts gained and lost, visibility delta per engine, tracked competitors newly named, and the likely causes (sources that started or stopped citing the brand).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_competitorsCompare the brand with its competitors in AI answers: visibility %, share of voice, average position and sentiment, overall and per engine.No findings

    Why it is in this group

    • The name "get_competitors" says "get": a word for reading.
    Description, as the server wrote it
    Compare the brand with its competitors in AI answers: visibility %, share of voice, average position and sentiment, overall and per engine.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_easiest_winsThird-party sites and pages cited in the answers the brand loses (competitor named, brand not), ranked by how many lost answers cite them, with the matching action-plan item.No findings

    Why it is in this group

    • The name "get_easiest_wins" says "get": a word for reading.
    Description, as the server wrote it
    Third-party sites and pages cited in the answers the brand loses (competitor named, brand not), ranked by how many lost answers cite them, with the matching action-plan item. Getting listed there is the shortest path back into those answers.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_prompt_gapsTracked prompts where AI names at least one competitor but not the brand, per engine, with the competitors named and the domains cited.No findings

    Why it is in this group

    • The name "get_prompt_gaps" says "get": a word for reading.
    Description, as the server wrote it
    Tracked prompts where AI names at least one competitor but not the brand, per engine, with the competitors named and the domains cited. Sorted by search volume (when a cached figure exists) then by number of competitors named. Start here to see what to win back.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_top_sourcesThe domains and URLs AI engines cite most when answering the brand's buyer questions, overall and per engine.No findings

    Why it is in this group

    • The name "get_top_sources" says "get": a word for reading.
    Description, as the server wrote it
    The domains and URLs AI engines cite most when answering the brand's buyer questions, overall and per engine. Use it to find where the brand should get listed or mentioned.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_usagePlan, quotas used and left (prompts, competitors, articles, manual scans), next automatic scan estimate, what this API key may do, and the API rate limits.No findings

    Why it is in this group

    • The name "get_usage" says "get": a word for reading.
    Description, as the server wrote it
    Plan, quotas used and left (prompts, competitors, articles, manual scans), next automatic scan estimate, what this API key may do, and the API rate limits. Call it before planning changes.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_visibilityHeadline AI visibility of a brand: % of AI answers that name it, share of voice vs competitors, average position, sentiment, per engine, plus the trend over the period (one point p…No findings

    Why it is in this group

    • The name "get_visibility" says "get": a word for reading.
    Description, as the server wrote it
    Headline AI visibility of a brand: % of AI answers that name it, share of voice vs competitors, average position, sentiment, per engine, plus the trend over the period (one point per scan).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • list_articlesArticles Howseen wrote for the brand (drafts, scheduled and published), with status, target question, GEO score and published URL.No findings

    Why it is in this group

    • The name "list_articles" says "list": a word for reading.
    Description, as the server wrote it
    Articles Howseen wrote for the brand (drafts, scheduled and published), with status, target question, GEO score and published URL.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • list_brandsList the brands (websites) tracked in this Howseen account, with their id, name and domain.No findings

    Why it is in this group

    • The name "list_brands" says "list": a word for reading.
    Description, as the server wrote it
    List the brands (websites) tracked in this Howseen account, with their id, name and domain. Call this first when the account may have several brands.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • list_promptsThe buyer questions (prompts) tracked for a brand, with per-prompt visibility, share of voice, position, which engines name the brand, and which brands and domains are cited.No findings

    Why it is in this group

    • The name "list_prompts" says "list": a word for reading.
    Description, as the server wrote it
    The buyer questions (prompts) tracked for a brand, with per-prompt visibility, share of voice, position, which engines name the brand, and which brands and domains are cited.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • search_responsesRead real AI answers collected for the brand: excerpts around the brand mention, whether the brand and which competitors were named, and the cited URLs.No findings

    Why it is in this group

    • The name "search_responses" says "search": a word for reading.
    Description, as the server wrote it
    Read real AI answers collected for the brand: excerpts around the brand mention, whether the brand and which competitors were named, and the cited URLs. Filter by a word in the question or answer (query), by prompt text, and by engine.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http howseen https://app.howseen.ai/api/mcp --header 'Authorization: <your-authorization>'

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__howseen__list_brands",
      "mcp__howseen__get_visibility",
      "mcp__howseen__list_prompts",
      "mcp__howseen__get_competitors",
      "mcp__howseen__get_top_sources",
      "mcp__howseen__search_responses",
      "mcp__howseen__get_action_plan",
      "mcp__howseen__list_articles",
      "mcp__howseen__get_prompt_gaps",
      "mcp__howseen__get_easiest_wins",
      "mcp__howseen__get_changes",
      "mcp__howseen__get_article_performance",
      "mcp__howseen__get_usage"
    ],
    "ask": [
      "mcp__howseen__suggest_prompts",
      "mcp__howseen__mark_action_done",
      "mcp__howseen__dismiss_action",
      "mcp__howseen__add_prompts",
      "mcp__howseen__add_competitor",
      "mcp__howseen__draft_article",
      "mcp__howseen__refresh_article",
      "mcp__howseen__create_share_report",
      "mcp__howseen__run_scan",
      "mcp__howseen__request_indexing",
      "mcp__howseen__restore_article"
    ],
    "deny": [
      "mcp__howseen__remove_prompts",
      "mcp__howseen__archive_prompts",
      "mcp__howseen__remove_competitor",
      "mcp__howseen__publish_article",
      "mcp__howseen__delete_article"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as howseen. Review it before you use it.