list_brands
List brands
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.
無需輸入參數。

ai.howseen由 howseen.ai 發布官方發布者v1.0.0更新於 Oct 26, 2026
How ChatGPT, Gemini, Perplexity and Google AI name your brand, cite sources and rank rivals.
Howseen 的遠端 MCP 伺服器讓助理查看品牌在 ChatGPT、Gemini、Perplexity 與 Google AI 回答中的表現,並據此採取行動。
Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/ai.howseen%2Fhowseen-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"howseen": {
"type": "http",
"url": "https://app.howseen.ai/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}Ask Claude, ChatGPT, Cursor or Codex how your brand shows up in AI answers, and act on it, without leaving your AI assistant.
Howseen tracks which brands ChatGPT, Gemini, Perplexity, Google AI Overviews and Google AI Mode recommend on the questions your buyers ask, which sources those engines cite, and writes the content to win the spots you are missing. This repository documents its remote MCP server.
https://app.howseen.ai/api/mcp (Streamable HTTP, remote, nothing to install)Authorization: Bearer <your Howseen API key>Replace hs_live_YOUR_KEY with your key.
Claude Code
Cursor (~/.cursor/mcp.json)
Codex
Claude.ai and ChatGPT (custom connector): these apps can only send the key inside the URL.
Treat that URL like a password: do not share it or show it on screen, and revoke the key in Settings if it leaks.
Read (any key)
Actions (key with actions enabled; every action previews first and only applies with confirm: true)
add_prompts, archive_prompts, remove_prompts, add_competitor, remove_competitor, mark_action_done, dismiss_action, draft_article, refresh_article, publish_article, request_indexing, create_share_report, delete_article, restore_article.
publish_article sends a written article to the brand's connected site (WordPress, Shopify, Ghost, BigCommerce, webhook) or its Howseen-hosted blog.
The same data is available as a read-only JSON API:
The MCP server and the API are included in the Pro plan (79 € a month) and the Business plans, and in the 3-day free trial. See https://howseen.ai/pricing.
Questions or issues: open an issue here or write to [email protected].
來源:README.md,提交 888389b
List brands
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.
無需輸入參數。
Get AI visibility
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).
tofrombrandengineList tracked prompts
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.
tofrombrandlimitengineoffsetGet competitors
Compare the brand with its competitors in AI answers: visibility %, share of voice, average position and sentiment, overall and per engine.
tofrombrandengineGet top cited sources
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.
tofrombrandlimitengineoffsetSearch AI answers
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.
tofrombrandlimitqueryengineoffsetpromptGet action plan
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.
tofromlangbrandlimitengineList articles
Articles Howseen wrote for the brand (drafts, scheduled and published), with status, target question, GEO score and published URL.
tofrombrandlimitoffsetGet prompt gaps
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.
tofrombrandlimitengineoffsetGet easiest wins
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.
tofromlangbrandlimitengineoffsetGet changes
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).
brandsinceengineSuggest prompts to track
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.
brandcountGet article performance
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.
tofrombrandlimitoffsetGet plan usage
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.
brandMark an action done
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.
brandconfirmaction_id必填Dismiss an action
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.
brandconfirmaction_id必填Add prompts to track
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.
brandtopicconfirmprompts必填Remove prompts
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.
brandconfirmprompts必填Archive prompts
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.
brandconfirmprompts必填Add a competitor
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.
brandconfirmcompetitor必填Remove a competitor
Stop tracking a competitor (by name or domain). Past results keep it. Preview first; confirm: true applies.
brandconfirmcompetitor必填Draft an article
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).
brandconfirmquestion必填Update an article with the current profile
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).
brandconfirmquestionarticle_idCreate a share report
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.
tofromlangbrandengineconfirmRun a visibility scan
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.
brandconfirmPublish an article
Publish a written article (e.g. a draft from draft_article) to the brand's connected CMS (WordPress, Shopify, Ghost, BigCommerce, GoHighLevel, Webflow, 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.
brandconfirmplatformarticle_id必填publish_atRequest search-engine indexing
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.
urlbrandconfirmarticle_id必填Delete an article
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.
brandconfirmarticle_id必填Restore a deleted article
Bring back an article from the Trash (e.g. one deleted with delete_article). Preview first; confirm: true restores.
brandconfirmarticle_id必填已滿足適用檢查項的 90%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
請在儲存庫或註冊中心條目中宣告授權條款。
claude mcp add --scope user --transport http howseen https://app.howseen.ai/api/mcp --header "Authorization: Bearer hs_live_YOUR_KEY"{ "mcpServers": { "howseen": { "url": "https://app.howseen.ai/api/mcp", "headers": { "Authorization": "Bearer hs_live_YOUR_KEY" } } }}export HOWSEEN_API_KEY=hs_live_YOUR_KEYcodex mcp add howseen --url https://app.howseen.ai/api/mcp --bearer-token-env-var HOWSEEN_API_KEYhttps://app.howseen.ai/api/mcp?key=hs_live_YOUR_KEYcurl -H "Authorization: Bearer hs_live_YOUR_KEY" https://app.howseen.ai/api/v1/brandscurl -H "Authorization: Bearer hs_live_YOUR_KEY" "https://app.howseen.ai/api/v1/brands/BRAND_ID/visibility?from=2026-09-01&engine=chatgpt"