Howseen

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

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)

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

Codex

export HOWSEEN_API_KEY=hs_live_YOUR_KEY
codex 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)

Tool	What it returns
list_brands	The 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_prompts	Tracked buyer questions with per-question visibility, engines and cited domains
get_competitors	Brand vs competitors in AI answers, overall and per engine
get_top_sources	Domains and URLs AI engines cite most on the brand's questions
search_responses	Real AI answers, with excerpts, brands named and cited URLs
get_action_plan	Prioritized actions to raise AI visibility
get_prompt_gaps	Questions where AI names a competitor but not the brand
get_easiest_wins	Third-party pages cited in the answers the brand loses, ranked
get_changes	What changed between the last two scans
suggest_prompts	Buyer questions worth tracking that are not tracked yet
list_articles	Articles Howseen wrote for the brand, with status and URL
get_article_performance	Published articles with indexing status, impressions and clicks
get_usage	Plan, 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:

curl -H "Authorization: Bearer hs_live_YOUR_KEY" https://app.howseen.ai/api/v1/brands
curl -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].