Track how AI assistants mention, cite, and rank your brand and competitors in AI search.
Connect Remote server
claude mcp add --transport http mcp https://api.athenahq.ai/api/mcp{
"mcpServers": {
"mcp": {
"url": "https://api.athenahq.ai/api/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "http",
"url": "https://api.athenahq.ai/api/mcp"
}
}
}Settings > Connectors > Add custom connector
URL: https://api.athenahq.ai/api/mcpTools 80 found in our last check
open_ai_accessOpen the AthenaHQ AI crawler access panel. Enter a public HTTPS domain to inspect crawler responses and robots.txt permissions without an AthenaHQ account.
check_public_ai_accessCheck 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 no…
get_prompt_schedulesList 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 selectio…
get_ai_search_valueAI 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.
get_promptsList prompts (search queries) tracked for a website
get_prompt_tagsList prompt tags for a website with per-tag prompt counts. Tag IDs can be used with the prompt_tags filter on the prompts endpoint.
get_personasList 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.
get_topicsList topics (groupings of prompts) for a website, with the count of prompts in each
get_competitorsList competitors tracked for a website
get_content_hub_sheetsList 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 i…
get_tracked_contentList 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 sh…
list_contentEnumerate 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),…
get_content_detailFetch 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 gen…
get_content_citation_promptsFor 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 ra…
list_websitesList 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…
get_locationsList geo-locations configured for a website
get_date_rangeGet the earliest and latest response dates for a website
get_responsesGet 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_respo…
get_response_streaming_statusRead the latest (or a specific) response-streaming run's whole-run state and response-queue progress. Only completed means downstream analysis has finished
get_response_detailFetch a single LLM response by id with full sources, mentions, and rank details.
get_saved_viewsList saved views (filter presets) for a website
get_group_saved_viewsList group-level saved views (filter presets) shared across the websites in a group
get_credits_organizationGet credit balance for the organization
get_credits_websiteGet credit balance for a specific website
get_groupsList all groups in the organization (global API key only)
get_group_detailFetch a single group by id with its member websites.
get_share_of_voice_cumulativeGet 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.
get_share_of_voice_time_seriesGet 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.
get_citation_rate_cumulativeGet 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.
get_citation_rate_time_seriesGet 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.
get_mention_rate_cumulativeGet 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.
get_mention_rate_time_seriesGet 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.
get_position_cumulativeGet cumulative position — average ranking position for each competitor across the date range.
get_position_time_seriesGet ranking position over time — average position of the website in AI model responses, grouped by day.
get_position_distributionGet position distribution: share of responses where the brand ranks top/middle/bottom across the date range.
query_metricsQuery aggregated metrics for brand performance, competitors, sources, citations, and response trends. Use query_rows for individual records. Mentions: from "response_mentions". Citations: from "citations". On either, where { is_website: true } selects the brand; { is_competitor:…
query_rowsQuery individual analytics rows. Use for qualitative data like response text, specific identifiers, or individual mentions. Schedule 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…
list_pitchesList pitch workspace reports for the organization. Returns all non-deleted pitches with their status and metadata.
get_pitchGet a pitch report by ID including competitors, prompts, attributes, top citing sources, and aggregate metrics (brand mentions, sentiment, response rate).
get_sourcesList 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…
get_youtube_creatorsList 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 paginatio…
get_youtube_videosList 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…
get_tiktok_creatorsList 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 share…
get_tiktok_pagesList 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 drilli…
get_source_pagesList 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, model…
get_attributesList 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…
get_attribute_metricsGet 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. `t…
get_competitor_attribute_metricsGet 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 agains…
get_attribute_time_seriesGet 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 t…
get_attribute_observationsGet 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…
get_user_by_emailLook 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.
get_oracle_findingsWhen 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 (…
get_oracle_findingWhen 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 fr…
list_api_keysList 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…
add_brand_factsAdd 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…
add_competitorsStart 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…
add_contentAdd 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 At…
approve_briefApprove 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 conte…
create_brand_kitCreate 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…
create_contentGenerate 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 fals…
create_locationCreate a location for a website
create_pillarCreate 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.
create_prompt_tagCreate 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…
create_promptsCreate one or more prompts on a website
create_saved_viewCreate 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", "v…
create_topicCreate a topic on a website (returns the existing topic when the name is already taken)
delete_brand_factsPermanently 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…
delete_contentDelete a content row. Destructive: physical row delete, no undo. Powers delete-and-retry. Bulk delete is out of scope.
delete_locationDelete a location from a website
delete_pillarsPermanently 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 unt…
delete_promptDelete a prompt (soft when responses exist, hard otherwise)
delete_topicDelete a topic (soft delete; optionally also delete its prompts)
draft_outreach_messageDraft 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…
edit_contentApply 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; z…
find_more_prompt_discoveryFind 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 pro…
find_outreach_authorFind 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 wit…
get_ai_insightRead 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 dir…
get_ai_insightsList 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 th…
get_brand_factsList 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 no…
get_brand_kitRead 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…
Details
| Endpoint | https://api.athenahq.ai/api/mcp (Streamable HTTP) |
| First published | 16 Oct 2026 |
| Last updated | 16 Oct 2026 |
| Registry name | ai.athenahq/mcp |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.