{"id":"ai.athenahq/mcp","slug":"ai-athenahq-mcp","title":"AthenaHQ","description":"Track how AI assistants mention, cite, and rank your brand and competitors in AI search.","version":"1.0.0","publisher":{"kind":"domain","id":"athenahq.ai","label":"athenahq.ai","url":"https://athenahq.ai"},"website":"https://docs.athenahq.ai/api-reference/mcp","repository":"","remotes":[{"type":"streamable-http","url":"https://api.athenahq.ai/api/mcp"}],"packages":[],"published":"2026-10-16","updated":"2026-10-16","status":"online","auth":"","latency_ms":1121,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"open_ai_access","title":"AI crawler access","description":"Open the AthenaHQ AI crawler access panel. Enter a public HTTPS domain to inspect crawler responses and robots.txt permissions without an AthenaHQ account.","read_only":true},{"name":"check_public_ai_access","title":"Check AI crawler access","description":"Check HTTP responses to AI crawler user agents and robots.txt permissions for a public website. No AthenaHQ account required. Search, retrieval and training are separate. Requests originate from AthenaHQ, not verified crawler IPs. Unknown responses are inconclusive; this does not measure visibility or guarantee indexing, citations or real crawler access. Use nullable evidence and diagnostics.","read_only":true},{"name":"get_prompt_schedules","title":"Get prompt schedules","description":"List the Default, custom and archived streaming schedules for a website. Use each row's selection value when filtering analytics or responses. Default includes all pre-cutover history and ad hoc runs; archived schedules retain results. To combine schedules, pass several selection values as an array in the schedule field of query_metrics and query_rows, or use a saved view that stores several sched","read_only":true},{"name":"get_ai_search_value","title":"Get ai search value","description":"AI Search Value for a website: topic-market value, captured value range, headroom, coverage, value-weighted AI share of voice, per-topic detail, and modeled attributed contribution.","read_only":true},{"name":"get_prompts","title":"Get prompts","description":"List prompts (search queries) tracked for a website","read_only":true},{"name":"get_prompt_tags","title":"Get prompt tags","description":"List prompt tags for a website with per-tag prompt counts. Tag IDs can be used with the prompt_tags filter on the prompts endpoint.","read_only":true},{"name":"get_personas","title":"Get personas","description":"List personas configured for a website with per-persona prompt counts. Use it to resolve persona_id values returned by other tools to persona names and descriptions.","read_only":true},{"name":"get_topics","title":"Get topics","description":"List topics (groupings of prompts) for a website, with the count of prompts in each","read_only":true},{"name":"get_competitors","title":"Get competitors","description":"List competitors tracked for a website","read_only":true},{"name":"get_content_hub_sheets","title":"Get content hub sheets","description":"List the Content Hub tabs/sheets configured for a website. Use to discover available tabs (e.g. 1st-party content, 3rd-party placements, Reddit) before calling get_tracked_content with a specific sheet_id (metrics; excludes in-flight pipeline items) or list_content (every item including unpublished drafts).","read_only":true},{"name":"get_tracked_content","title":"Get tracked content","description":"List tracked content (1st-party drafts, imported pages, 3rd-party placements) with citation, mention, and impression metrics for the supplied date range and filters. Supports pagination via page_num / page_size and optional filtering by Content Hub sheet_id or content_type. A sheet_id of a view-type tab (see get_content_hub_sheets sheet_type) lists the shared main pool: content not filed in any sh","read_only":true},{"name":"list_content","title":"List content","description":"Enumerate every content item in a website's Content Hub, published or not: in-flight drafts, briefs, snipes, optimize and slice runs, scheduled and failed items, plus tracked pages. Returns identity fields only (id, title, type, stage, sheet, URL, timestamps, target prompt ids), no metrics. Uncached and Postgres-backed, so an item created by create_content is listable immediately. Filter by sheet_","read_only":true},{"name":"get_content_detail","title":"Get content detail","description":"Fetch the full detail of a single tracked content item — its brief and body text (drafts, optimize rewrites, snipes, authored and scraped pages), plus status, cited source URLs, and links. Use after get_tracked_content to read the actual text behind a content_id. A status of generated_brief means the brief is ready while the article is still being written. Pages registered via track_content_urls r","read_only":true},{"name":"get_content_citation_prompts","title":"Get content citation prompts","description":"For a single tracked content item, list every prompt whose AI responses cited it — with citations, citation %, and estimated impressions. Use after get_tracked_content to drill into which prompts a given URL is appearing for. This is CITED-BY, measured over the requested date range, not the targeting the page was written for: an empty prompts array means no AI response cited this URL in that windo","read_only":true},{"name":"list_websites","title":"List websites","description":"List every website accessible to the calling session. Works with any API key (global or scoped) and with MCP/OAuth sessions. Call with an empty argument object `{}`. Each item includes `baseCountry`, the country market the website targets: use it to tell same-brand websites for different countries apart.","read_only":true},{"name":"get_locations","title":"Get locations","description":"List geo-locations configured for a website","read_only":true},{"name":"get_date_range","title":"Get date range","description":"Get the earliest and latest response dates for a website","read_only":true},{"name":"get_responses","title":"Get responses","description":"Get LLM responses for a website. Shows how AI models answer queries, with sources, sentiment, and ranking data. Filter by whether a model used search queries or by text within those queries. For a variation-level export at volume, pair filters.variation_filter with include_response: false and compact_sources: true. That keeps the prompt, its variation, the model, the mentioned/cited flags and the ","read_only":true},{"name":"get_response_streaming_status","title":"Get response streaming status","description":"Read the latest (or a specific) response-streaming run's whole-run state and response-queue progress. Only completed means downstream analysis has finished","read_only":true},{"name":"get_response_detail","title":"Get response detail","description":"Fetch a single LLM response by id with full sources, mentions, and rank details.","read_only":true},{"name":"get_saved_views","title":"Get saved views","description":"List saved views (filter presets) for a website","read_only":true},{"name":"get_group_saved_views","title":"Get group saved views","description":"List group-level saved views (filter presets) shared across the websites in a group","read_only":true},{"name":"get_credits_organization","title":"Get credits organization","description":"Get credit balance for the organization","read_only":true},{"name":"get_credits_website","title":"Get credits website","description":"Get credit balance for a specific website","read_only":true},{"name":"get_groups","title":"Get groups","description":"List all groups in the organization (global API key only)","read_only":true},{"name":"get_group_detail","title":"Get group detail","description":"Fetch a single group by id with its member websites.","read_only":true},{"name":"get_share_of_voice_cumulative","title":"Get share of voice cumulative","description":"Get cumulative share of voice — overall SOV for each competitor across the date range. Each entry also includes relative_mention_rate: the share of responses mentioning any tracked brand that mention this entity.","read_only":true},{"name":"get_share_of_voice_time_series","title":"Get share of voice time series","description":"Get share of voice over time — how often the website is mentioned vs competitors, grouped by day. Each entry also includes relative_mention_rate: the share of that day's responses mentioning any tracked brand that mention this entity.","read_only":true},{"name":"get_citation_rate_cumulative","title":"Get citation rate cumulative","description":"Get cumulative citation rate — average citation rate for each competitor across the date range. citation_rate is absolute (share of all responses); relative_citation_rate is the share of responses citing the website or any tracked competitor.","read_only":true},{"name":"get_citation_rate_time_series","title":"Get citation rate time series","description":"Get citation rate over time — how often AI models cite (link to) the website, grouped by day. citation_rate is absolute (share of that day's responses); relative_citation_rate is the share of that day's responses citing the website or any tracked competitor.","read_only":true},{"name":"get_mention_rate_cumulative","title":"Get mention rate cumulative","description":"Get cumulative mention rate — average mention rate for each competitor across the date range. mention_rate is absolute (share of all responses); relative_mention_rate is the share of responses mentioning any tracked brand.","read_only":true},{"name":"get_mention_rate_time_series","title":"Get mention rate time series","description":"Get mention rate over time — how often AI models mention the website by name, grouped by day. mention_rate is absolute (share of that day's responses); relative_mention_rate is the share of that day's responses mentioning any tracked brand.","read_only":true},{"name":"get_position_cumulative","title":"Get position cumulative","description":"Get cumulative position — average ranking position for each competitor across the date range.","read_only":true},{"name":"get_position_time_series","title":"Get position time series","description":"Get ranking position over time — average position of the website in AI model responses, grouped by day.","read_only":true},{"name":"get_position_distribution","title":"Get position distribution","description":"Get position distribution: share of responses where the brand ranks top/middle/bottom across the date range.","read_only":true},{"name":"query_metrics","title":"Query metrics","description":"Query aggregated metrics for brand performance, competitors, sources, citations, and response trends. Use query_rows for individual records.\n\nMentions: from \"response_mentions\". Citations: from \"citations\". On either, where { is_website: true } selects the brand; { is_competitor: true } selects competitors; { entity_id: { eq: \"<uuid>\" } } selects one entity.\nFilter/group models by model_category (","read_only":true},{"name":"query_rows","title":"Query rows","description":"Query individual analytics rows. Use for qualitative data like response text, specific identifiers, or individual mentions.\n\nSchedule selection: pass schedule: \"default\" or a custom/archived UUID from the schedule catalog, or an array of them to combine schedules. Omit to use the caller default (Ask Athena uses the current page selection). Explicit selection overrides that default. Existing top-le","read_only":true},{"name":"list_pitches","title":"List pitches","description":"List pitch workspace reports for the organization. Returns all non-deleted pitches with their status and metadata.","read_only":true},{"name":"get_pitch","title":"Get pitch","description":"Get a pitch report by ID including competitors, prompts, attributes, top citing sources, and aggregate metrics (brand mentions, sentiment, response rate).","read_only":true},{"name":"get_sources","title":"Get sources","description":"List top cited sources (root domains) for a website with citation, mention, brand-mention, and impression metrics. Each row is classified as owned / competitor / partner / third_party. Supports filters (date range, models, prompts, competitors, locations, personas), source_tags (tag IDs from source_tags__list, owned, competitor, other, untagged), sort, and pagination via page_num / page_size.","read_only":true},{"name":"get_youtube_creators","title":"Get youtube creators","description":"List YouTube channels cited in AI answers for a website, ordered by citations (unknown channel last). Includes channel citation shares, category and video-length breakdowns, and metadata availability. Totals and breakdowns cover the full filtered result, independent of pagination. Use get_youtube_videos with channel_key to list a creator's videos. Reads saved metadata; pending or missing details r","read_only":true},{"name":"get_youtube_videos","title":"Get youtube videos","description":"List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch ","read_only":true},{"name":"get_tiktok_creators","title":"Get tiktok creators","description":"List TikTok handles cited in AI answers, ordered by citations with unattributed URLs last. Includes profiles, videos and photos across tiktok.com, www, m, vm and vt hosts. Handles come from cited URLs, not verified account identities; short links are not resolved. Citation shares and totals cover all filtered TikTok citations, including unattributed URLs, independent of pagination. Use get_tiktok_","read_only":true},{"name":"get_tiktok_pages","title":"Get tiktok pages","description":"List TikTok URLs cited in AI answers, ordered by citations. Includes profile, video, photo and unattributed URLs. Filter by channel_key from get_tiktok_creators. Each page's share_percent and totals use all filtered TikTok citations, including unattributed URLs, even when drilling into one channel or paginating. These are AI-answer citation counts, not TikTok views or engagement. No scraping or li","read_only":true},{"name":"get_source_pages","title":"Get source pages","description":"List individual cited URLs (pages) for a website with citation, mention, and impression metrics plus a per-URL daily sparkline. Each row is classified as owned / competitor / partner / third_party. Companion to get_sources (root-domain-level). Supports filters (date range, models, prompts, competitors, locations, personas), source_tags (tag IDs from source_tags__list, owned, competitor, other, unt","read_only":true},{"name":"get_attributes","title":"Get attributes","description":"List the brand traits (called attributes in the API) tracked for a website: brand-perception keywords such as 'Affordable' or 'Slow Support'. Athena extracts these from AI model responses. Brand traits are direction-neutral; `positive` selects the directional series and defaults to true when omitted. Use this to discover attribute ids, then get_attribute_metrics for how often each is mentioned, or","read_only":true},{"name":"get_attribute_metrics","title":"Get attribute metrics","description":"Get cumulative brand trait (attribute) metrics: for each brand-perception keyword (e.g. 'Affordable', 'Slow Support'), how many AI responses mentioned it across the date range, and the percentage. `positive` selects the observation direction and defaults to true when omitted. `total_responses` is the denominator: responses in the date range that mention the brand AND had attribute extraction run o","read_only":true},{"name":"get_competitor_attribute_metrics","title":"Get competitor attribute metrics","description":"Get brand trait (attribute) metrics per tracked competitor: for each competitor and each brand-perception keyword (e.g. 'Affordable'), how many AI responses mentioned that keyword for that competitor, and the percentage. Use with get_attribute_metrics to compare the brand against competitors. `total_responses` is per-competitor: responses in the date range that mention THAT competitor and had attr","read_only":true},{"name":"get_attribute_time_series","title":"Get attribute time series","description":"Get the daily trend for ONE brand trait (attribute), brand and competitors side by side — how mentions of a keyword like 'Affordable' moved over time. Requires an attribute_id: call get_attributes first to discover ids. `positive` selects the observation direction and defaults to true when omitted. Days with no data are returned as zeros, so the series is gap-free and chartable. Denominators are p","read_only":true},{"name":"get_attribute_observations","title":"Get attribute observations","description":"Get individual brand trait (attribute) observations: each row is one AI response describing one entity (the brand or a competitor) with one brand trait, including the response excerpt as `text_span`. `score` runs from -1 to 1 and its sign always matches `positive`; its magnitude (0.1 to 1.0) is how strongly the wording praises or criticizes. `score` is null when the observation was not scored (ext","read_only":true},{"name":"get_user_by_email","title":"Get user by email","description":"Look up a user by email address, scoped to the caller's organization. Returns 404 when the email does not belong to a member of the organization or of one of its websites.","read_only":true},{"name":"get_oracle_findings","title":"Get oracle findings","description":"When grounding is present, use its complete team-confirmed statement and all supporting facts as joint evidence; the legacy fact ID/text are only a compatibility anchor. List Oracle accuracy findings for a website: places where an AI response contradicted a verified brand fact (type 'inaccuracy' or 'kb_issue', with quote, claim, and reason) or where two knowledge-base facts conflict ('kb_duplicate","read_only":true},{"name":"get_oracle_finding","title":"Get oracle finding","description":"When grounding is present, use its complete team-confirmed statement and all supporting facts as joint evidence; the legacy fact ID/text are only a compatibility anchor. Load one Oracle finding in full: the flagged claim with its verified fact and prompt text, the run it came from, a ~2000-character response excerpt centered on the quoted claim, the cited-page evidence captured during the run (url","read_only":true},{"name":"list_api_keys","title":"List api keys","description":"List the organization's API key metadata, including creator and creation date, oldest first. Includes revoked keys so polling can detect keys revoked between checks. Never returns secrets or hashes. Requires a global API key or an organization admin's MCP connection. For polling, keep since/until fixed while paging, overlap successive windows and deduplicate by id. This is an inventory, not a dura","read_only":true},{"name":"add_brand_facts","title":"Add brand facts","description":"Add brand facts to a website's Knowledge Base in bulk (1-50 per call). Each fact runs the full ingestion pipeline (deduplication, approval gates, pillar routing); there is no way to force-approve. Returns one outcome per fact (approved | pending | duplicate; extensible) with the created fact id and the pillar it was filed under. Facts without a pillar_id are routed automatically and may land unfil","read_only":false},{"name":"add_competitors","title":"Add competitors","description":"Start tracking competitors on a website, 1 to 25 per call, under the same rules as the Competitors page. Each competitor needs a name and its website url, or no_website: true for a brand with no website of its own; identifiers and additional_urls are optional. Returns one result per competitor, in order: added, already_tracked (the website already tracks that url; nothing changes), or rejected wit","read_only":false},{"name":"add_content","title":"Add content","description":"Add an article that is already written (for example, one drafted in this conversation) to the website's Content Hub as an editable draft. Same as pasting it into the Content Hub's blank editor: no AI model runs and no content credits are spent. Use create_content instead when Athena should research and write the piece. body is the full article in Markdown and is stored as given, except that link a","read_only":false},{"name":"approve_brief","title":"Approve brief","description":"Approve a content brief and start writing the article from it. Only valid while the piece is at status generated_brief. The article is generated from the brief exactly as it currently stands, including any revisions made with revise_brief or edits made in the app. Consumes content credits; poll get_content_status afterwards, then read the result with get_content_draft.","read_only":false},{"name":"create_brand_kit","title":"Create brand kit","description":"Create a brand kit from text the user provides: a name, guidance text per field (voice is the writing direction), voice settings and writing rules, all authored by the caller; nothing is generated. The kit starts as a draft; content generation uses it only once published, which publish: true does as version 1 (or update_brand_kit later). The website's first kit becomes its default. A name another ","read_only":false},{"name":"create_content","title":"Generate an article or content brief","description":"Generate an article or content brief in AthenaHQ. Fetches source URLs, sends source material to external AI providers, and consumes content credits. Obtain user approval before calling. Does not publish to a website or CMS. For draft mode, auto_approve defaults to true; set false to generate only a brief and wait for approve_brief. Poll get_content_status using each returned content_ids value. Sli","read_only":false},{"name":"create_location","title":"Create location","description":"Create a location for a website","read_only":false},{"name":"create_pillar","title":"Create pillar","description":"Create a Knowledge Base pillar (a subject area that groups brand facts) from a name and optional description. Get-or-create semantics: if a pillar with the same name already exists, it is returned with created: false instead of failing, so retries are idempotent.","read_only":false},{"name":"create_prompt_tag","title":"Create prompt tag","description":"Create a prompt tag on a website, or return the existing tag when its name matches case-insensitively. Trims surrounding whitespace and rejects reserved prompt-type names. Returns the tag ID and whether it was created. Use the returned ID to assign the tag to prompts; creating a tag does not assign it to any prompts.","read_only":false},{"name":"create_prompts","title":"Create prompts","description":"Create one or more prompts on a website","read_only":false},{"name":"create_saved_view","title":"Create saved view","description":"Create a saved view (filter preset) for a website. Saved views appear in the dashboard filter bar for every member of the website. filters is an object keyed by filter field key, each value shaped {\"id\": \"<unique string>\", \"field\": \"<same field key>\", \"operator\": \"is_any_of\", \"values\": [...]}. Common field keys: \"models\" (slugs like \"chatgpt\", \"perplexity\", \"google_ai_overview\"), \"competitors\", \"p","read_only":false},{"name":"create_topic","title":"Create topic","description":"Create a topic on a website (returns the existing topic when the name is already taken)","read_only":false},{"name":"delete_brand_facts","title":"Delete brand facts","description":"Permanently delete 1-50 brand facts from a website's Knowledge Base. There is no undo. Ids that do not exist on the website are reported in not_found_ids rather than failing the call, so retries are idempotent. Requires an admin; on OAuth connections the signed-in user must have the admin role.","read_only":false},{"name":"delete_content","title":"Delete content","description":"Delete a content row. Destructive: physical row delete, no undo. Powers delete-and-retry. Bulk delete is out of scope.","read_only":false},{"name":"delete_location","title":"Delete location","description":"Delete a location from a website","read_only":false},{"name":"delete_pillars","title":"Delete pillars","description":"Permanently delete 1-20 Knowledge Base pillars and every fact filed under them. Facts are deleted, not unfiled; there is no undo. Ids that do not exist on the website are reported in not_found_ids rather than failing the call, so retries are idempotent; ids in failed_ids are untouched and safe to retry. Requires an admin; on OAuth connections the signed-in user must have the admin role.","read_only":false},{"name":"delete_prompt","title":"Delete prompt","description":"Delete a prompt (soft when responses exist, hard otherwise)","read_only":false},{"name":"delete_topic","title":"Delete topic","description":"Delete a topic (soft delete; optionally also delete its prompts)","read_only":false},{"name":"draft_outreach_message","title":"Draft an Outreach pitch","description":"Draft a pitch email to the author of a cited page and save it as the page's Outreach draft, replacing any previous draft. Uses the website's team-wide Outreach custom instructions, the saved author name, and the sender's name. Costs 0.1 credits per draft written (billed in whole credits every 10 drafts); free when the page cannot be read. Show the draft to the user before they send it; nothing is ","read_only":false},{"name":"edit_content","title":"Edit content","description":"Apply exact find-and-replace edits to a content draft's article body. Deterministic, no AI model involved: your replacement text lands verbatim (use revise_content when you want an AI rewrite from an instruction). Each edit's find text must match the current body exactly once; zero or multiple matches fail the whole call and nothing is saved, so extend the find text until it is unique. Edits apply","read_only":false},{"name":"find_more_prompt_discovery","title":"Find more prompt discovery","description":"Find more prompts for a finished Discover run: start the next round of its series with the same sources, effort level, country, language and custom instructions. The round skips every question the series already suggested and reads evidence earlier rounds did not use, so its prompts add to the same list. Invoke only after the user asks for more prompts from an existing run, and confirm with them f","read_only":false},{"name":"find_outreach_author","title":"Find a cited page's author","description":"Find who wrote a cited page and how to reach them, then save it to the page's Outreach contact. Reads the page's byline, the addresses the page publishes, and Hunter.io; when no author is found it returns the site's contact address and contact page instead. Every email comes with its source. Costs 0.1 credits when an author is found (billed in whole credits every 10 lookups); free otherwise. Overw","read_only":false},{"name":"get_ai_insight","title":"Get AI insight","description":"Read one stored AI insight in full, by its id from get_ai_insights: its title, headline, body, suggested action, why it happened (with reasons and their pages), its numbers (facts, each with the table it came from), its move (subject, metric, current and previous values, the direction that is good news, and a definition of what the series counts and what it is out of), its evidence (topics, compet","read_only":true},{"name":"get_ai_insights","title":"Get AI insights","description":"List the website's stored AI insights: the precomputed cards on the AI Insights page, each a verified finding of one past analysis, newest analysis first and higher impact first. Each has its id, title, headline, category, impact, the days its numbers cover (window), the time the analysis ran (analyzed_at), its status (available, done, or discarded = hidden by the team), the team's rating, and its","read_only":true},{"name":"get_brand_facts","title":"Get brand facts","description":"List a website's brand facts from the Knowledge Base, newest first, with offset paging. By default excludes facts generated by Oracle analysis; pass include_oracle=true to include them. Filters: pillar, review status (default approved), source type, and unfiled=true for facts not under any published pillar (unfiled and pillar_id are mutually exclusive).","read_only":true},{"name":"get_brand_kit","title":"Get brand kit","description":"Read a brand kit as the Brand Profile editor shows it, to inspect or change it: the draft name, the eight guidance fields as text (voice is the writing direction), voice settings (1-5 or auto), tone traits, the kit's writing rules with ids, and the website's global writing rules with ids, plus draft and published versions. Omit kit_id for the website's default kit; available_kits lists every kit. ","read_only":true}],"server_info":{"name":"athenahq","version":"0.1.0"},"category":"news","tags":["agents","web-search","social"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":291167,"score":100,"indexable":true,"first_seen":"2026-10-16","stars":0,"badges":["official"],"sponsor":null,"page":"https://agentsindex.org/agents/ai-athenahq-mcp/"}