AthenaHQ

Permanently delete a custom source tag and all its pattern assignments; retain source records. Built-in tags and Owned/Competitor cannot be deleted; remove patterns from a built-in tag instead. Read the listing first and pass the tag's revision as expected-revision. Obtain explicit user confirmation identifying the tag and its patterns before calling. MCP executes immediately after authorization; Athena AI chat presents an approval card. If the tag changed, read again. Never retry a declined proposal unless asked. A false analytics-refresh result means the tag was deleted but filtered analytics may still be cached.

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, the domains no tag covers at all. Built-in tags (platform) and Owned/Competitor (entity) are refused as tag IDs: their membership is automatic and not listable; add or remove patterns on them instead. Start from untagged when asked which domains still need tags or which new tags to suggest.

Read every source tag this website sees: Owned and Competitor (entity), the built-in classes AthenaHQ classifies automatically (platform: Media, Social, Government, E-Commerce, Review sites, PR Wire, Academic and research, Wiki) and the website's custom tags. Built-in tags list only what this website added or removed, never the platform's own patterns; custom tags list their patterns. Read this before proposing, creating, editing or deleting tags, and prefer adding hosts to a built-in tag over creating a near-duplicate. To find sources no tag covers, call source_tags__get_sources with untagged true. Filter by name substring or tag ID; page tags with offset, page one tag's patterns with tag ID and pattern offset.

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 they carry the tag here, or remove patterns so they stop carrying it here; a removal is accepted only for a pattern the tag currently applies to (by a platform rule, by automatic classification, or by your own addition), and an addition is accepted only when the pattern does not already carry the tag. Owned and Competitor cannot be edited here; their patterns live in Brand Profile and Competitors. Read the listing first and pass the tag's revision as expected-revision. Obtain explicit user confirmation of the exact changes before calling; MCP executes immediately after authorization; Athena AI chat presents an approval card. If the tag changed, read again. Never retry a declined proposal unless asked. Up to 500 additions and 500 removals. A false analytics-refresh result means the edit saved but filtered analytics may still be cached.

Start a Discover study to find evidence-grounded, untracked prompt opportunities for a website. Invoke after explicit user intent to start research and review the sources, country, language, requested prompt count and custom instructions with the user. This launches asynchronous external research and model calls; the prompt count is a target, not a guaranteed yield. Sources: website_analysis (website), social (market discussions), search_console (connected Search Console), keyword_gaps (plan-gated keyword opportunities), competitive_landscape (plan-gated category questions and comparisons researched from the website's tracked competitors; requires at least one tracked competitor), brand_guidelines (requires custom instructions). Returns the run ID and version when startup succeeds. Prompts are not automatically added to tracking. Poll the discovery history/progress tool with the returned run ID; do not start another study to check status. Requires prompt-management permission and source entitlements. Candidate results can be reviewed in the application's Discover page.

Run tracked prompts against external AI providers to collect new responses for a website. Sends prompt text to the selected providers, stores their responses in AthenaHQ, and consumes response credits. Starts immediately; use only for a user-requested run. Returns a workflow_id; poll get_response_streaming_status over MCP or GET /api/v1/response-streaming/status over the API for progress.

Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website's monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer's own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. If the user names a destination tab, resolve its id with get_content_hub_sheets before tracking. Omitting sheet_id uses the shared pool, not the user's currently open tab. After the call, report created_count and skipped_count separately, name the returned destination_name, and share content_hub_url so the user can open each item. Skipped rows keep their existing tab: use their returned destination and never describe them as newly added or moved.

Update one brand fact's text, source URL, or confidence in the Knowledge Base. Only provided fields change; pass source_url: "" to clear the source. Changing the text creates a new fact (new id) and archives the current one; the new fact keeps the current review status and the response carries it. Source URL and confidence edits update the fact in place. Duplicates across other facts are not rejected here (Knowledge Base dedup owns those). Does not change review status.

Add or remove identifiers on the website's brand, or on one competitor, under the same rules as the Competitors page. Call get_identifiers first. The name and domain cannot be removed. An identifier that is already listed, or that another tracked brand or competitor on this website already uses, is refused, and nothing is saved. New AI responses use the change right away. Past responses are reanalyzed only when someone runs the backfill on the Competitors page, which costs credits; this tool never starts it. changes_awaiting_backfill counts the edits waiting for it, not responses.

Update a location for a website

Edit a cited page's Outreach contact: author name, email, LinkedIn, or the draft's subject and body. Creates the contact when the page has none. Supply at least one field; only the fields supplied change, and null clears a field. A changed email is labeled as entered manually. Each change is recorded in the contact's activity history. Obtain user confirmation of the new values before calling.

Update a Knowledge Base pillar's name, description, or status. At least one of name, description, or status must be provided; only provided fields change, and description: "" clears the stored description. Renaming fails with a conflict when another pillar already uses the name. Status accepts published or archived: archiving hides the pillar from get_pillars and stops its facts feeding content generation, while keeping the facts stored.

Update a prompt's metadata (text, type, topic, geography)

Update a topic's name or description