# AthenaHQ MCP connector The AthenaHQ connector brings your AI search visibility, prompts, responses, competitors and tracked content to Claude, ChatGPT, Cursor and the Elaichi Agent, so anyone can ask how your brand shows up in AI answers. Source: https://elaichi.ai/connectors/athenahq/ ## Facts | | | | --- | --- | | Application | AthenaHQ | | Category | Analytics | | AI tools | 94 | | Authentication | Connects over OAuth | | Bring your own OAuth app | No | | Native MCP | Yes. AthenaHQ builds and runs this MCP server. Elaichi adds sign-in, access controls and an audit log on top | | Support for its tools | support@athenahq.ai | | MCP endpoint | https://api.elaichi.ai/mcp | | Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent | | Tools advertised by name | No. Connected tools are never listed one by one, however few there are. The endpoint advertises `search_tools` and `execute_tool` instead | ## What you can ask once AthenaHQ is connected - Which prompts mentioned our competitors more than us this week? - Summarize this month's AI responses for our pricing topic. - Which of our tracked content got cited in AI responses lately? ## Connect AthenaHQ in Elaichi This happens once for the organization, before any client is involved. 1. Open Connections, choose Add connection, and pick AthenaHQ. 2. Optionally set Share with, then press Connect. 3. Approve it in AthenaHQ. AthenaHQ's own window opens. Whoever approves it decides what this connection can reach. Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which AthenaHQ tools are exposed, rename them, or freeze arguments before anyone points a client at it. ## AthenaHQ MCP connector for Claude Endpoint: https://api.elaichi.ai/mcp 1. Open Customize, then Connectors. 2. Press Add. 3. Name it, paste the MCP server URL, then Continue. 4. Sign in and approve. On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves. ## AthenaHQ MCP connector for ChatGPT Endpoint: https://api.elaichi.ai/mcp 1. Open Plugins, then press the + button. 2. Name it and paste the endpoint into Server URL. 3. Leave Authentication on OAuth, then tick the risk acknowledgement. 4. Press Create, then sign in and approve. Works on the web today. The plugin directory lives at chatgpt.com/plugins. ## AthenaHQ MCP connector for Cursor Endpoint: https://api.elaichi.ai/mcp 1. Open `~/.cursor/mcp.json`. 2. Add the endpoint under `mcpServers`. 3. Reload Cursor, then sign in and approve. Set up per machine, so repeat it on each computer you work from. ## Connect AthenaHQ to any MCP client Endpoint: https://api.elaichi.ai/mcp 1. Add the endpoint as a remote MCP server. 2. Sign in and approve. The Elaichi Agent already has these tools, with nothing to set up. ## What the consent screen decides Only Read is granted by default, which is not enough to call a AthenaHQ tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone. ## What teams do with AthenaHQ through Elaichi ### Check this week's AI visibility before standup Marketing. Ask how often your brand appeared in AI responses for your tracked prompts over the last date range, and which topics moved. The answer comes from live AthenaHQ data, not a screenshot someone exported on Friday. ### Find which pages AI answers actually cite Content. Pull your tracked content and content hub sheets, then ask which pages earned citations and for which prompts. Plan the next brief around what already gets quoted. ### See how each persona hears about you Brand. Compare responses across your AthenaHQ personas and locations to see where the brand story lands and where it goes missing. ### Watch competitors in the same prompts Product marketing. Ask which competitors show up alongside you in AI responses for a topic, and how that has changed. Take the comparison straight into positioning work. ### Brief a client from their saved views Agency. Open a client's websites and saved views in AthenaHQ, ask for the highlights, and turn them into a client-ready update in minutes. ### Know what AI search is worth Leadership. Ask for the AI search value and credit usage for the organization and each website, so budget conversations start from real numbers. ## Elaichi vs Zapier MCP vs Composio for AthenaHQ All three can connect AthenaHQ to an AI assistant, and all three have admin controls. They differ in where access lives and how you pay. | What to check | Elaichi | Zapier MCP | Composio | | --- | --- | --- | --- | | Where the AI connects | One address for the whole organization. Endpoint: https://api.elaichi.ai/mcp | A server per member, created at sign-in. | An MCP endpoint per team, or an SDK. | | Control over AthenaHQ tools | Allow or restrict single AthenaHQ tools, per role or user. | App and action restrictions on the account. | Role permissions, down to the action. | | Record of calls | One audit entry per AthenaHQ call. | A History tab of tool calls. | A log of every tool call. | | Single sign-on | SAML or OIDC, plus SCIM, on Gold. | SAML on Enterprise. | SAML and OIDC on Enterprise. | | Price | $15 per user per month. | 2 tasks per successful call. | Billed per tool call. | Sources: Zapier MCP [docs](https://docs.zapier.com/mcp/get-started/quickstart), [security](https://docs.zapier.com/mcp/manage/security), [usage](https://docs.zapier.com/mcp/features/usage); Composio [docs](https://docs.composio.dev/docs/composio-connect), [gateway](https://composio.dev/mcp-gateway), [enterprise](https://composio.dev/enterprise), [pricing](https://composio.dev/pricing). Checked September 2026. Longer take: [Zapier MCP alternative](/blog/zapier-mcp-alternative/) and [when you don't need an MCP gateway](/blog/when-you-dont-need-an-mcp-gateway/). ## Frequently asked questions ### How do I connect AthenaHQ to Claude? Connect AthenaHQ in Elaichi first: AthenaHQ connects over OAuth, so you sign in to your AthenaHQ account in a browser window and approve access, with no client ID or secret to generate. Then in Claude open Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Claude asks you to sign in to Elaichi, and from then on it can work with your AthenaHQ prompts, responses and content as you. ### Does AthenaHQ work with ChatGPT and Cursor as well as Claude? Yes. Once AthenaHQ is connected in Elaichi, Claude, ChatGPT, Cursor, the Elaichi Agent and any other MCP client use the same endpoint, https://api.elaichi.ai/mcp. You connect AthenaHQ once and every client picks it up. ### What can an AI agent actually do with my AthenaHQ data? With AthenaHQ connected, an agent can read your tracked prompts and their schedules, the AI responses they produced, your personas, topics, competitors, locations and saved views, and your tracked content with the prompts that cite it. It can also report AI search value and credit usage for the organization and each website. Short, concrete asks work best, such as which competitors appeared in pricing prompts this month. ### Does connecting AthenaHQ give the AI access to every website and workspace? No. Access follows the person who signed in to AthenaHQ, so the agent sees only the websites, prompts and responses that person can already open in AthenaHQ. Elaichi can narrow that further with roles and restrictions, and it never widens it. ### Can my team share one AthenaHQ connection? Yes. One person connects AthenaHQ in Elaichi and shares the connection with a team, and nobody else ever handles the AthenaHQ login. Each teammate still signs in to Elaichi as themselves, so the audit log names the person behind every call. ### Can I stop an agent from deleting or changing things in AthenaHQ? Yes. The AthenaHQ connector is mostly about reading prompts, responses, content and credits, and whatever actions exist can be restricted one by one in Elaichi. A restricted action is never advertised to Claude, ChatGPT or Cursor, so no prompt, however worded, can reach it. ### What happens to an AthenaHQ connection when someone leaves? Offboarding a person in Elaichi ends their access to AthenaHQ through every client at once. If they had shared an AthenaHQ connection with a team, it keeps working for everyone else. If you want AthenaHQ gone entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor and the Elaichi Agent together. ### Does the AthenaHQ MCP connector work with Gemini, Codex, Claude Code or other MCP clients? Yes. AthenaHQ is reached over the same MCP endpoint every client uses, so anything that speaks MCP can call it — Gemini, Codex, Claude Code, Windsurf, Cline, Zed and OpenCode among them — alongside Claude, ChatGPT, Cursor, and the Elaichi Agent. The tools on offer and the access behind them are identical whichever client asks. Only the setup screen differs. ### Is Elaichi an alternative to Zapier MCP for AthenaHQ? Yes. Both let Claude, ChatGPT or Cursor use AthenaHQ. Zapier MCP fits a team that already automates in Zapier, since each person signs in and acts as themselves in that account. Elaichi fits when IT wants one address for the whole company, per-tool rules by role, and a record of every AthenaHQ call. ### How is Elaichi different from Composio for AthenaHQ? Composio gives AI agents tools and sign-in handling across 1,000+ apps, for developers building agents or people using an assistant, billed per tool call. Elaichi gives a company's own people governed access to AthenaHQ: one address, restrictions per role or user, and $15 per user per month. Both have role permissions and a log of every call. ## All 94 AthenaHQ tools Every tool below is callable through https://api.elaichi.ai/mcp once AthenaHQ is connected, subject to the toolbox it is in and the restrictions on the caller. - **Open AI access** (Open). Open 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 access** (Action). 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… - **Get prompt schedules** (Get). 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… - **Get AI search value** (Search). 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. - **Get prompts** (Get). List prompts (search queries) tracked for a website - **Get prompt tags** (Get). 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 personas** (Get). 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. - **Get topics** (Get). List topics (groupings of prompts) for a website, with the count of prompts in each - **Get competitors** (Get). List competitors tracked for a website - **Get content hub sheets** (Get). 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… - **Get tracked content** (Get). 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.… - **List content** (List). 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… - **Get content detail** (Get). 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… - **Get content citation prompts** (Get). 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… - **List websites** (List). 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… - **Get locations** (Get). List geo-locations configured for a website - **Get date range** (Get). Get the earliest and latest response dates for a website - **Get responses** (Get). 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… - **Get response streaming status** (Get). 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 response detail** (Get). Fetch a single LLM response by id with full sources, mentions, and rank details. - **Get saved views** (Get). List saved views (filter presets) for a website - **Get group saved views** (Get). List group-level saved views (filter presets) shared across the websites in a group - **Get credits organization** (Get). Get credit balance for the organization - **Get credits website** (Get). Get credit balance for a specific website - **Get groups** (Get). List all groups in the organization (global API key only) - **Get group detail** (Get). Fetch a single group by id with its member websites. - **Get share of voice cumulative** (Get). 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. - **Get share of voice time series** (Get). 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. - **Get citation rate cumulative** (Get). Get cumulative citation rate — average citation rate for each competitor across the date range. - **Get citation rate time series** (Get). Get citation rate over time — how often AI models cite (link to) the website, grouped by day. - **Get mention rate cumulative** (Get). 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. - **Get mention rate time series** (Get). 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. - **Get position cumulative** (Get). Get cumulative position — average ranking position for each competitor across the date range. - **Get position time series** (Get). Get ranking position over time — average position of the website in AI model responses, grouped by day. - **Get position distribution** (Get). Get position distribution: share of responses where the brand ranks top/middle/bottom across the date range. - **Query metrics** (Search). Query 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; {… - **Query rows** (Search). Query 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… - **List pitches** (List). List pitch workspace reports for the organization. Returns all non-deleted pitches with their status and metadata. - **Get pitch** (Get). Get a pitch report by ID including competitors, prompts, attributes, top citing sources, and aggregate metrics (brand mentions, sentiment, response rate). - **Get sources** (Get). 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), sort, and… - **Get source pages** (Get). 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,… - **Get attributes** (Get). 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… - **Get attribute metrics** (Get). 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.… - **Get competitor attribute metrics** (Get). 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… - **Get attribute time series** (Get). 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… - **Get attribute observations** (Get). 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… - **Get user by email** (Get). 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. - **Get oracle findings** (Get). 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… - **Get oracle finding** (Get). 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… - **Add brand facts** (Add). 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… - ...and 44 more tools. Call `tools/list` via the MCP endpoint, or see the full catalog via the API, for the complete set.