# Athenahq MCP server

Source: https://glimind.com/server/mcp-registry%2Fai.athenahq%2Fmcp
Registry id: `mcp-registry/ai.athenahq/mcp`
Status: live (checked 2026-10-27T02:33:25.923Z)

## Measurements (30 days)

- Uptime: 100%
- Checks: 2530
- Outages (90 days): 0

## Install

```json
{
  "mcpServers": {
    "athenahq-mcp-server": {
      "type": "http",
      "url": "https://api.athenahq.ai/api/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http athenahq-mcp-server https://api.athenahq.ai/api/mcp
```

## Tools (110)

- `add_brand_facts`: 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
- `add_content`: 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 int
- `approve_brief`: 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 
- `check_public_ai_access`: 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
- `create_content`: Generate an article or content brief in AthenaHQ. Fetches source URLs, sends source material to external AI providers, and consumes content credits. Obtain user
- `create_location`: Create a location for a website
- `create_pillar`: 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
- `create_prompt_tag`: 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-
- `create_prompts`: Create one or more prompts on a website
- `create_saved_view`: 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
- `create_topic`: Create a topic on a website (returns the existing topic when the name is already taken)
- `delete_brand_facts`: 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
- `delete_content`: Delete a content row. Destructive: physical row delete, no undo. Powers delete-and-retry. Bulk delete is out of scope.
- `delete_location`: Delete a location from a website
- `delete_pillars`: 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 w
- `delete_prompt`: Delete a prompt (soft when responses exist, hard otherwise)
- `delete_topic`: Delete a topic (soft delete; optionally also delete its prompts)
- `draft_outreach_message`: 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 
- `edit_content`: 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_cont
- `find_more_prompt_discovery`: 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
- `find_outreach_author`: 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 H
- `get_ai_search_value`: 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 att
- `get_attribute_metrics`: Get cumulative brand trait (attribute) metrics: for each brand-perception keyword (e.g. 'Affordable', 'Slow Support'), how many AI responses mentioned it across
- `get_attribute_observations`: Get individual brand trait (attribute) observations: each row is one AI response describing one entity (the brand or a competitor) with one brand trait, includi
- `get_attribute_time_series`: 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 
- `get_attributes`: List the brand traits (called attributes in the API) tracked for a website: brand-perception keywords such as 'Affordable' or 'Slow Support'. Athena extracts th
- `get_brand_facts`: 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_ora
- `get_citation_rate_cumulative`: Get cumulative citation rate — average citation rate for each competitor across the date range.
- `get_citation_rate_time_series`: Get citation rate over time — how often AI models cite (link to) the website, grouped by day.
- `get_competitor_attribute_metrics`: Get brand trait (attribute) metrics per tracked competitor: for each competitor and each brand-perception keyword (e.g. 'Affordable'), how many AI responses men
- `get_competitors`: List competitors tracked for a website
- `get_content_citation_prompts`: For a single tracked content item, list every prompt whose AI responses cited it — with citations, citation %, and estimated impressions. Use after get_tracked_
- `get_content_detail`: 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, c
- `get_content_draft`: Read the current draft text of a content item — the article body as it stands right now, including every revision applied so far. Use this before revise_content
- `get_content_hub_sheets`: 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_content_status`: Get the normalized pipeline status (running | succeeded | failed) for one content row, plus the raw stage behind it. Read-only. Poll once per contentId returned
- `get_content_version`: Read the full text of one saved version of a content item. Use it to compare two passes (fetch both and diff them yourself) or to check what an earlier version 
- `get_content_versions`: List the saved versions of a content item, newest first. Each entry carries its version number, label, how it was produced, and who made it. Use it to see how a
- `get_credit_usage`: Read recorded organization credit consumption: total, hourly (24h) or daily trend, and charged website/group/organization pools. Use for spending trends and big
- `get_credit_usage_events`: Read a page of recorded credit charges/refunds and action labels for the organization, optionally filtered by originatingWebsiteId. Use to inspect a usage spike
- `get_credits_organization`: Get credit balance for the organization
- `get_credits_website`: Get credit balance for a specific website
- `get_date_range`: Get the earliest and latest response dates for a website
- `get_group_detail`: Fetch a single group by id with its member websites.
- `get_group_saved_views`: List group-level saved views (filter presets) shared across the websites in a group
- `get_groups`: List all groups in the organization (global API key only)
- `get_identifiers`: Read the identifiers of the website's brand, or of one competitor: the names, aliases and domains Athena looks for in AI responses to count a mention. default_i
- `get_locations`: List geo-locations configured for a website
- `get_mention_rate_cumulative`: Get cumulative mention rate — average mention rate for each competitor across the date range. mention_rate is absolute (share of all responses); relative_mentio
- `get_mention_rate_time_series`: 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
- `get_oracle_finding`: 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 compatibilit
- `get_oracle_findings`: 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 compatibilit
- `get_personas`: 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 descript
- `get_pillar_document`: Fetch a pillar's synthesized markdown document from the Knowledge Base. Returns document: null when the pillar exists but has no synthesized document yet.
- `get_pillars`: List a website's Knowledge Base pillars (excluding archived ones) with approved-fact counts, whether a synthesized document exists, and when each pillar was las
- `get_pitch`: Get a pitch report by ID including competitors, prompts, attributes, top citing sources, and aggregate metrics (brand mentions, sentiment, response rate).
- `get_position_cumulative`: Get cumulative position — average ranking position for each competitor across the date range.
- `get_position_distribution`: Get position distribution: share of responses where the brand ranks top/middle/bottom across the date range.
- `get_position_time_series`: Get ranking position over time — average position of the website in AI model responses, grouped by day.
- `get_prompt_discovery_runs`: Read Discover history and progress for a website, or supply the run ID returned by discovery launch to inspect one study. Distinguishes pending, running, comple
- `get_prompt_schedules`: List the Default, custom and archived streaming schedules for a website. Use each row's selection value when filtering analytics or responses. Default includes 
- `get_prompt_tags`: 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.
- `get_prompts`: List prompts (search queries) tracked for a website
- `get_response_detail`: Fetch a single LLM response by id with full sources, mentions, and rank details.
- `get_response_streaming_status`: Read the latest (or a specific) response-streaming run's whole-run state and response-queue progress. Only completed means downstream analysis has finished
- `get_responses`: 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
- `get_saved_views`: List saved views (filter presets) for a website
- `get_seo_rankings`: Read saved Google organic rankings by explicit market and device alongside observed AI visibility. Includes recent history, missing-data reasons, freshness and 
- `get_share_of_voice_cumulative`: 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 me
- `get_share_of_voice_time_series`: 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 t
- `get_shopping_metrics`: Get the Shopping Insights dashboard for a website over a date range: how often the brand's products appear in AI shopping answers (product carousels) versus com
- `get_source_pages`: 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 
- `get_sources`: List top cited sources (root domains) for a website with citation, mention, brand-mention, and impression metrics. Each row is classified as owned / competitor 
- `get_topics`: List topics (groupings of prompts) for a website, with the count of prompts in each
- `get_tracked_content`: List tracked content (1st-party drafts, imported pages, 3rd-party placements) with citation, mention, and impression metrics for the supplied date range and fil
- `get_user_by_email`: 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 it
- `list_content`: 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
- `list_outreach_contacts`: Read saved Outreach contacts: cited pages with their status, author, email and where the email came from, LinkedIn, contact page, and pitch draft. Only pages so
- `list_pitches`: List pitch workspace reports for the organization. Returns all non-deleted pitches with their status and metadata.
- `list_websites`: 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 
- `merge_pillars`: Merge 1-20 source pillars into a published target pillar: every fact on the sources (any review status) re-files onto the target, page links carry over keeping 
- `move_brand_facts`: File 1-50 brand facts under a published Knowledge Base pillar — works for unfiled facts and re-files facts from other pillars. Review status never changes, and 
- `move_content`: Move one or more content items to a different Content Hub sheet, or back to the shared pool. Sheet assignment is organizational metadata only: a move never chan
- `open_ai_access`: Open the AthenaHQ AI crawler access panel. Enter a public HTTPS domain to inspect crawler responses and robots.txt permissions without an AthenaHQ account.
- `publish_content`: Record an already-published article's URL in AthenaHQ for citation and mention tracking. Does not upload or publish content to a website or CMS. Call only after
- `query_metrics`: Query aggregated metrics for brand performance, competitors, sources, citations, and response trends. Use query_rows for individual records. Mentions: from "res
- `query_rows`: Query individual analytics rows. Use for qualitative data like response text, specific identifiers, or individual mentions. Schedule selection: pass schedule: "
- `rename_content`: Rename a content row's title. URL editing is not supported — URL is the content asset's stable identity and cannot be changed here.
- `restore_content_version`: Bring an earlier version's text back as the current draft — use it when a later pass came out worse than an earlier one. Nothing is deleted: the restored text i
- `revise_brief`: Rewrite a content brief from a natural-language instruction (for example: 'add a section on pricing objections', 'cut the competitor comparison'). An AI model p
- `revise_content`: Rewrite an existing content draft from a natural-language instruction (for example: 'tighten the intro', 'add a section on pricing', 'remove the second half'). 
- `search_brand_facts`: Semantic search over a website's approved brand facts in the Knowledge Base. Reaches facts not filed under any pillar. Returns fact text with confidence, source
- `set_outreach_status`: Move cited pages to an Outreach pipeline status (New, Todo, In Progress, Done, Rejected), as the Outreach inbox and board do. Each change to an existing contact
- `set_prompt_tags`: Replace all tag assignments on an existing prompt. For additions or removals, read the prompt's current tags with get_prompts, resolve tag IDs with get_prompt_t
- `set_prompts_status`: Pause or unpause multiple prompts in one transaction
- `source_tags__create`: Create a custom source tag with a name, URL patterns and optionally an icon and colour. Read the tag listing first: built-in tags already cover media, social, g
- `source_tags__delete`: Permanently delete a custom source tag and all its pattern assignments; retain source records. Built-in tags and Owned/Competitor cannot be deleted; remove patt
- `source_tags__get_sources`: List cited domains by tag coverage, most cited first with citation counts: either the domains one custom source tag matches (tag ID), or, with untagged true, th
- `source_tags__list`: Read every source tag this website sees: Owned and Competitor (entity), the built-in classes AthenaHQ classifies automatically (platform: Media, Social, Governm
- `source_tags__update`: Edit a source tag. Custom tag: rename, add patterns, remove exact patterns from the listing. Built-in tag (platform): add patterns to this website's copy so the

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.