Howseen

ai.howseenPublished by howseen.aiOfficial publisherv1.0.0Updated Oct 26, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Howseen's remote MCP server lets an assistant read how a brand appears in AI answers across ChatGPT, Gemini, Perplexity and Google AI, and act on it.

What you can do
  • List tracked brands and read headline AI visibility, share of voice, position and sentiment per engine
  • Inspect tracked buyer prompts, competitor comparisons, prompt gaps and the sources AI engines cite
  • Read real AI answers, recent scan changes, prioritized action plans and easiest-win pages
  • Review articles, their GEO scores, indexing status and search performance, plus plan quotas and limits
  • Manage prompts and competitors, mark or dismiss actions, draft, refresh, publish, delete or restore articles
  • Create public share reports, run scans and request search-engine indexing
When to use it
Useful for marketing or SEO work where you need to know which brands AI assistants recommend for buyer questions, where the brand is missing, and which pages to get listed on. Also fits teams that want an assistant to draft and publish content aimed at those questions.
Requirements
Remote Streamable HTTP endpoint; nothing to install. Requires a Howseen account and API key sent as an Authorization bearer token, created in the dashboard under Settings > API & AI assistants. Actions need a key with actions enabled. Paid Pro or Business plan after the 3-day trial.
Before you install
The API key is a live credential; clients that can only pass it in the URL should treat that URL like a password and revoke the key if it leaks. Many tools change account state and only apply with confirm: true, including publishing articles publicly to a connected CMS, deleting articles, removing prompts or competitors, and creating public share links. Publishing and drafting consume plan allowances, and scans are rate-limited by plan cadence.

Installation

In SourceWeft

  1. Open Howseen in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.howseen%2Fhowseen-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "howseen": {
      "type": "http",
      "url": "https://app.howseen.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Howseen MCP server

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.

  • Server URL: https://app.howseen.ai/api/mcp (Streamable HTTP, remote, nothing to install)
  • Auth: Authorization: Bearer <your Howseen API key>
  • Docs: https://howseen.ai/mcp
  • Get a key: Howseen dashboard > Settings > API & AI assistants (3-day free trial)

Connect your AI assistant

Replace hs_live_YOUR_KEY with your key.

Claude Code

bash
claude mcp add --scope user --transport http howseen https://app.howseen.ai/api/mcp --header "Authorization: Bearer hs_live_YOUR_KEY"

Cursor (~/.cursor/mcp.json)

json
{  "mcpServers": {    "howseen": {      "url": "https://app.howseen.ai/api/mcp",      "headers": { "Authorization": "Bearer hs_live_YOUR_KEY" }    }  }}

Codex

bash
export HOWSEEN_API_KEY=hs_live_YOUR_KEYcodex mcp add howseen --url https://app.howseen.ai/api/mcp --bearer-token-env-var HOWSEEN_API_KEY

Claude.ai and ChatGPT (custom connector): these apps can only send the key inside the URL.

https://app.howseen.ai/api/mcp?key=hs_live_YOUR_KEY

Treat that URL like a password: do not share it or show it on screen, and revoke the key in Settings if it leaks.

What you can ask

  • "What is my AI visibility this month, per engine?"
  • "On which buyer questions does ChatGPT name a competitor and not us?"
  • "Which sites does AI cite when we lose? Where should we get listed first?"
  • "What changed since the last scan?"
  • "Draft an article for the question we lose the most, then publish it to our site."

Tools

Read (any key)

ToolWhat it returns
list_brandsThe brands (websites) tracked in the account
get_visibility% of AI answers that name the brand, share of voice, average position, sentiment, per engine, with the trend
list_promptsTracked buyer questions with per-question visibility, engines and cited domains
get_competitorsBrand vs competitors in AI answers, overall and per engine
get_top_sourcesDomains and URLs AI engines cite most on the brand's questions
search_responsesReal AI answers, with excerpts, brands named and cited URLs
get_action_planPrioritized actions to raise AI visibility
get_prompt_gapsQuestions where AI names a competitor but not the brand
get_easiest_winsThird-party pages cited in the answers the brand loses, ranked
get_changesWhat changed between the last two scans
suggest_promptsBuyer questions worth tracking that are not tracked yet
list_articlesArticles Howseen wrote for the brand, with status and URL
get_article_performancePublished articles with indexing status, impressions and clicks
get_usagePlan, quotas used and left, API limits

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.

REST API

The same data is available as a read-only JSON API:

bash
curl -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"

Pricing

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.

Support

Questions or issues: open an issue here or write to [email protected].

Source: README.md at commit 888389b

Tools

29

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.

Takes no parameters.

get_visibility

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).

Parameterstofrombrandengine

list_prompts

List 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.

Parameterstofrombrandlimitengineoffset

get_competitors

Get competitors

Compare the brand with its competitors in AI answers: visibility %, share of voice, average position and sentiment, overall and per engine.

Parameterstofrombrandengine

get_top_sources

Get 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.

Parameterstofrombrandlimitengineoffset

search_responses

Search 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.

Parameterstofrombrandlimitqueryengineoffsetprompt

get_action_plan

Get 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.

Parameterstofromlangbrandlimitengine

list_articles

List articles

Articles Howseen wrote for the brand (drafts, scheduled and published), with status, target question, GEO score and published URL.

Parameterstofrombrandlimitoffset

get_prompt_gaps

Get 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.

Parameterstofrombrandlimitengineoffset

get_easiest_wins

Get 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.

Parameterstofromlangbrandlimitengineoffset

get_changes

Get 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).

Parametersbrandsinceengine

suggest_prompts

Suggest 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.

Parametersbrandcount

get_article_performance

Get 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.

Parameterstofrombrandlimitoffset

get_usage

Get 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.

Parametersbrand

mark_action_done

Mark 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.

Parametersbrandconfirmaction_idrequired

dismiss_action

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.

Parametersbrandconfirmaction_idrequired

add_prompts

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.

Parametersbrandtopicconfirmpromptsrequired

remove_prompts

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.

Parametersbrandconfirmpromptsrequired

archive_prompts

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.

Parametersbrandconfirmpromptsrequired

add_competitor

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.

Parametersbrandconfirmcompetitorrequired

remove_competitor

Remove a competitor

Stop tracking a competitor (by name or domain). Past results keep it. Preview first; confirm: true applies.

Parametersbrandconfirmcompetitorrequired

draft_article

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).

Parametersbrandconfirmquestionrequired

refresh_article

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).

Parametersbrandconfirmquestionarticle_id

create_share_report

Create 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.

Parameterstofromlangbrandengineconfirm

run_scan

Run 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.

Parametersbrandconfirm

publish_article

Publish 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.

Parametersbrandconfirmplatformarticle_idrequiredpublish_at

request_indexing

Request 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.

Parametersurlbrandconfirmarticle_idrequired

delete_article

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.

Parametersbrandconfirmarticle_idrequired

restore_article

Restore a deleted article

Bring back an article from the Trash (e.g. one deleted with delete_article). Preview first; confirm: true restores.

Parametersbrandconfirmarticle_idrequired

Version history

1
  1. v1.0.0LatestOct 20, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.