Servers Playground How we check Add a server Log in

Howseen

Working · 2.3 s

ai.howseen/howseen-mcpv1.0.0 Domain verified

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

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://app.howseen.ai/api/mcp

Authorization (required)

Bearer token: your Howseen API key (Settings > API & AI assistants), as 'Bearer hs_live_...'

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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

competitorstring, required

Competitor name or URL, e.g. "Notion" or "https://notion.so".

brandstring

Brand id, name or domain (from list_brands). Optional when the account has a single brand.

confirmboolean

Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Howseen MCP server | mcptry

Tools (29)

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

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
competitor*	string	Competitor name or URL, e.g. "Notion" or "https://notion.so".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "competitor"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "competitor": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Competitor name or URL, e.g. \"Notion\" or \"https://notion.so\"."
    }
  }
}

add_prompts

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.

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
topic	string	Optional topic to file them under.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
prompts*	array	Buyer questions to track, 1 to 25.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "prompts"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "topic": {
      "type": "string",
      "maxLength": 60,
      "description": "Optional topic to file them under."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "prompts": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "Buyer questions to track, 1 to 25."
    }
  }
}

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.

destructive

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
prompts*	array	Exact prompt texts (from list_prompts).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "prompts"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "prompts": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "Exact prompt texts (from list_prompts)."
    }
  }
}

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

Argument	Type	Description
to	string	End date YYYY-MM-DD.
from	string	Start date YYYY-MM-DD. Default: all time.
lang	string	Report language (default en).
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
engine	string	Optional engines, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "lang": {
      "enum": [
        "en",
        "fr",
        "es"
      ],
      "type": "string",
      "description": "Report language (default en)."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "engine": {
      "type": "string",
      "description": "Optional engines, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    }
  }
}

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

destructive

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
article_id*	string	Article id from list_articles.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "article_id"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "article_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Article id from list_articles."
    }
  }
}

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

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
action_id*	string	Action id from get_action_plan.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "action_id"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "action_id": {
      "type": "string",
      "maxLength": 400,
      "minLength": 1,
      "description": "Action id from get_action_plan."
    }
  }
}

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

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
question*	string	The buyer question the article must answer, e.g. a prompt from get_prompt_gaps.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "question"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "question": {
      "type": "string",
      "maxLength": 300,
      "minLength": 8,
      "description": "The buyer question the article must answer, e.g. a prompt from get_prompt_gaps."
    }
  }
}

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.

read-only

Argument	Type	Description
to	string	End date YYYY-MM-DD. Default: now.
from	string	Start date YYYY-MM-DD. Default: all time.
lang	string	Language of the action texts (default en).
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
limit	integer	Max items to return (default 10, max 50).
engine	string	Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD. Default: now."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "lang": {
      "enum": [
        "en",
        "fr",
        "es"
      ],
      "type": "string",
      "description": "Language of the action texts (default en)."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max items to return (default 10, max 50)."
    },
    "engine": {
      "type": "string",
      "description": "Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines."
    }
  }
}

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.

read-only

Argument	Type	Description
to	string	End date YYYY-MM-DD. Default: now.
from	string	Start date YYYY-MM-DD. Default: all time.
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
limit	integer	Max items to return (default 20, max 100).
offset	integer	Items to skip, for pagination.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD. Default: now."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max items to return (default 20, max 100)."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Items to skip, for pagination."
    }
  }
}

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

read-only

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
since	string	Optional YYYY-MM-DD: compare the latest scan with the last scan on or before this date. Default: the previous scan.
engine	string	Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "since": {
      "type": "string",
      "description": "Optional YYYY-MM-DD: compare the latest scan with the last scan on or before this date. Default: the previous scan."
    },
    "engine": {
      "type": "string",
      "description": "Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines."
    }
  }
}

get_competitors

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

read-only

Argument	Type	Description
to	string	End date YYYY-MM-DD. Default: now.
from	string	Start date YYYY-MM-DD. Default: all time.
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
engine	string	Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD. Default: now."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "engine": {
      "type": "string",
      "description": "Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines."
    }
  }
}

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.

read-only

Argument	Type	Description
to	string	End date YYYY-MM-DD. Default: now.
from	string	Start date YYYY-MM-DD. Default: all time.
lang	string	Language of the action texts (default en).
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
limit	integer	Max items to return (default 10, max 50).
engine	string	Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines.
offset	integer	Items to skip, for pagination.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD. Default: now."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "lang": {
      "enum": [
        "en",
        "fr",
        "es"
      ],
      "type": "string",
      "description": "Language of the action texts (default en)."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max items to return (default 10, max 50)."
    },
    "engine": {
      "type": "string",
      "description": "Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Items to skip, for pagination."
    }
  }
}

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.

read-only

Argument	Type	Description
to	string	End date YYYY-MM-DD. Default: now.
from	string	Start date YYYY-MM-DD. Default: all time.
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
limit	integer	Max items to return (default 25, max 100).
engine	string	Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines.
offset	integer	Items to skip, for pagination.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD. Default: now."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max items to return (default 25, max 100)."
    },
    "engine": {
      "type": "string",
      "description": "Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Items to skip, for pagination."
    }
  }
}

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

read-only

Argument	Type	Description
to	string	End date YYYY-MM-DD. Default: now.
from	string	Start date YYYY-MM-DD. Default: all time.
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
limit	integer	Max items to return (default 20, max 100).
engine	string	Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines.
offset	integer	Items to skip, for pagination.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD. Default: now."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max items to return (default 20, max 100)."
    },
    "engine": {
      "type": "string",
      "description": "Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Items to skip, for pagination."
    }
  }
}

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

read-only

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    }
  }
}

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

read-only

Argument	Type	Description
to	string	End date YYYY-MM-DD. Default: now.
from	string	Start date YYYY-MM-DD. Default: all time.
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
engine	string	Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD. Default: now."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "engine": {
      "type": "string",
      "description": "Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines."
    }
  }
}

list_articles

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

read-only

Argument	Type	Description
to	string	End date YYYY-MM-DD. Default: now.
from	string	Start date YYYY-MM-DD. Default: all time.
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
limit	integer	Max items to return (default 20, max 100).
offset	integer	Items to skip, for pagination.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD. Default: now."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max items to return (default 20, max 100)."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Items to skip, for pagination."
    }
  }
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

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

read-only

Argument	Type	Description
to	string	End date YYYY-MM-DD. Default: now.
from	string	Start date YYYY-MM-DD. Default: all time.
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
limit	integer	Max items to return (default 50, max 200).
engine	string	Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines.
offset	integer	Items to skip, for pagination.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD. Default: now."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max items to return (default 50, max 200)."
    },
    "engine": {
      "type": "string",
      "description": "Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Items to skip, for pagination."
    }
  }
}

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

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
action_id*	string	Action id, e.g. offpage:g2.com or content:<prompt>.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "action_id"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "action_id": {
      "type": "string",
      "maxLength": 400,
      "minLength": 1,
      "description": "Action id, e.g. offpage:g2.com or content:<prompt>."
    }
  }
}

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

destructive

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
platform	string	Optional: wordpress, shopify, ghost, bigcommerce, webhook, nextjs (hosted blog / Next.js feed) or api. Default: the CMS Autopilot uses (most recently connected).
article_id*	string	Article id from list_articles or get_article_performance.
publish_at	string	Optional YYYY-MM-DD after today to schedule instead of publishing now (Autopilot must be ON).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "article_id"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "platform": {
      "type": "string",
      "maxLength": 30,
      "description": "Optional: wordpress, shopify, ghost, bigcommerce, webhook, nextjs (hosted blog / Next.js feed) or api. Default: the CMS Autopilot uses (most recently connected)."
    },
    "article_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Article id from list_articles or get_article_performance."
    },
    "publish_at": {
      "type": "string",
      "description": "Optional YYYY-MM-DD after today to schedule instead of publishing now (Autopilot must be ON)."
    }
  }
}

refresh_article

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

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
question	string	Or the article's target question (the most recent written article for it).
article_id	string	Article id from list_articles.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "question": {
      "type": "string",
      "maxLength": 300,
      "description": "Or the article's target question (the most recent written article for it)."
    },
    "article_id": {
      "type": "string",
      "maxLength": 64,
      "description": "Article id from list_articles."
    }
  }
}

remove_competitor

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

destructive

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
competitor*	string	Tracked competitor name or domain.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "competitor"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "competitor": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Tracked competitor name or domain."
    }
  }
}

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.

destructive

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
prompts*	array	Exact prompt texts (from list_prompts).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "prompts"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "prompts": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1
      },
      "maxItems": 25,
      "minItems": 1,
      "description": "Exact prompt texts (from list_prompts)."
    }
  }
}

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

Argument	Type	Description
url	string	Live https URL of the article on the brand's own site (needed when you publish it yourself from the API or feed).
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
article_id*	string	Id of a published article.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "article_id"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Live https URL of the article on the brand's own site (needed when you publish it yourself from the API or feed)."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "article_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Id of a published article."
    }
  }
}

restore_article

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

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.
article_id*	string	Id of the deleted article (from delete_article's result).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "article_id"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    },
    "article_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Id of the deleted article (from delete_article's result)."
    }
  }
}

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

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
confirm	boolean	Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "confirm": {
      "type": "boolean",
      "description": "Leave out (or false) to get a preview: nothing changes. Set true ONLY after the user approved that exact preview."
    }
  }
}

search_responses

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.

read-only

Argument	Type	Description
to	string	End date YYYY-MM-DD. Default: now.
from	string	Start date YYYY-MM-DD. Default: all time.
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
limit	integer	Max items to return (default 10, max 50).
query	string	Optional text to search in the question or the answer.
engine	string	Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines.
offset	integer	Items to skip, for pagination.
prompt	string	Optional text the tracked prompt must contain.

Input schema (JSON)

suggest_prompts

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.

read-only

Argument	Type	Description
brand	string	Brand id, name or domain (from list_brands). Optional when the account has a single brand.
count	integer	How many AI suggestions (default 10, max 25).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "count": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "How many AI suggestions (default 10, max 25)."
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD. Default: now."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD. Default: all time."
    },
    "brand": {
      "type": "string",
      "description": "Brand id, name or domain (from list_brands). Optional when the account has a single brand."
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max items to return (default 10, max 50)."
    },
    "query": {
      "type": "string",
      "description": "Optional text to search in the question or the answer."
    },
    "engine": {
      "type": "string",
      "description": "Optional AI engine filter, comma separated: chatgpt, gemini, perplexity, ai_overviews, ai_mode. Default: all engines."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Items to skip, for pagination."
    },
    "prompt": {
      "type": "string",
      "description": "Optional text the tracked prompt must contain."
    }
  }
}