Aurora Docs
MCP Server

Available Tools

Reference for all tools provided by the Aurora MCP server.

What Can You Do?

Aurora's MCP server gives your AI assistant access to your GEO tracking data. Here's what you can ask:

  • Track your brand — Check how often AI platforms mention and cite your brand over time
  • Spy on competitors — See which competing brands and domains appear in AI responses for your queries
  • Analyze sources — Find out which URLs and domains AI models cite most frequently
  • Spot trends — Compare visibility across providers, queries, and time periods

For complete workflow examples, see Use Cases.

Response Format

All data tools return a structured response with three sections:

{
  "metadata": {
    "campaign_id": "abc-123",
    "period": { "from": "2025-01-01T...", "to": "2025-03-20T..." },
    "total_rows": 847,
    "rows_returned": 100,
    "offset": 0,
    "truncated": true
  },
  "summary": { },
  "data": [ ]
}
SectionDescription
metadataTime period, total row count, pagination info
summaryPre-aggregated data (by brand, by provider, etc.) — useful for quick answers without scanning all rows
dataThe actual data rows (paginated, default 100 per request)

Pagination

Results are paginated with a default limit of 100 rows. Use limit and offset to page through large datasets:

  • First request: limit: 100, offset: 0 (default)
  • Next page: limit: 100, offset: 100
  • Check metadata.truncated — if true, there are more rows available

list_campaigns

List all GEO tracking campaigns for your account.

Parameters: None

Returns: Array of campaigns with:

FieldTypeDescription
idstringCampaign ID (use in other tools)
namestringCampaign name
countrystringTarget country
country_codestringISO country code
created_atstringCreation timestamp

Try asking:

  • "List my Aurora campaigns"
  • "Which campaigns do I have set up?"
  • "Show me all my tracking campaigns"

Example response:

You have 2 campaigns:

  1. My Brand US — United States, created Jan 15, 2025
  2. My Brand DE — Germany, created Feb 3, 2025

get_brand_visibility

Get brand visibility scores across AI providers.

Parameters:

ParamTypeRequiredDescription
campaign_idstringYesCampaign ID from list_campaigns
start_datestringNoStart date (YYYY-MM-DD)
end_datestringNoEnd date (YYYY-MM-DD)
limitnumberNoMax rows to return (default 100)
offsetnumberNoSkip this many rows for pagination (default 0)

Response includes:

Metadata: period, total_rows, rows_returned, truncated, unique_brands, unique_providers, unique_queries

Summary:

FieldDescription
by_brandEach brand with avg_visibility_score, total_mentions, total_citations, is_own_brand
by_providerEach provider with avg_visibility_score

Data rows:

FieldTypeDescription
datestringTimestamp
providerstringAI provider (chatgpt, gemini, perplexity, copilot, google_ai_mode, ai_overview, yandex)
query_textstringThe tracked query
brand_namestringBrand name
brand_domainstringBrand domain
is_own_brandbooleanWhether this is your own brand
mentionsnumberNumber of mentions
citationsnumberNumber of citations
visibility_scorenumberVisibility score (0–1)

Try asking:

  • "How visible is my brand across AI platforms this week?"
  • "Show brand visibility trends for the last 30 days"
  • "Compare my brand's mentions on ChatGPT vs Gemini"

Example response:

Here's your brand visibility for the past 7 days:

ProviderAvg ScoreMentionsCitations
ChatGPT0.724518
Gemini0.583112
Perplexity0.855234

Perplexity gives you the most visibility, with 0.85 avg score and the highest citation count. ChatGPT mentions you frequently but links to your site less often.


get_citations

Get citation data showing which URLs are cited by AI providers.

Parameters:

ParamTypeRequiredDescription
campaign_idstringYesCampaign ID from list_campaigns
start_datestringNoStart date (YYYY-MM-DD)
end_datestringNoEnd date (YYYY-MM-DD)
limitnumberNoMax rows to return (default 100)
offsetnumberNoSkip this many rows for pagination (default 0)

Response includes:

Metadata: period, total_rows, rows_returned, truncated, unique_domains, unique_providers, unique_queries

Summary:

FieldDescription
top_domainsTop 20 domains with citations count and avg_visibility_score
by_providerEach provider with citations count and avg_visibility_score

Data rows:

FieldTypeDescription
datestringTimestamp
providerstringAI provider
query_textstringThe tracked query
urlstringCited URL
domainstringDomain of the cited URL
titlestringPage title
positionnumberPosition in the response
categorystringCitation category
visibility_scorenumberVisibility score (0–1)

Try asking:

  • "Which URLs are AI models citing for my queries?"
  • "What are the top cited domains this month?"
  • "Show me competitor domains that appear in AI responses"

Example response:

Top 5 cited domains across all providers (last 30 days):

  1. example.com — 89 citations (your domain)
  2. competitor-a.com — 67 citations
  3. wikipedia.org — 42 citations
  4. competitor-b.com — 38 citations
  5. reddit.com — 25 citations

Your domain leads in citations. competitor-a.com is your closest rival, especially on ChatGPT where they get cited 3x more than on other providers.


get_keyword_counts

Get keyword frequency data from AI provider responses.

Parameters:

ParamTypeRequiredDescription
campaign_idstringYesCampaign ID from list_campaigns
start_datestringNoStart date (YYYY-MM-DD)
end_datestringNoEnd date (YYYY-MM-DD)
limitnumberNoMax rows to return (default 100)
offsetnumberNoSkip this many rows for pagination (default 0)

Response includes:

Metadata: period, total_rows, rows_returned, truncated, unique_keywords, unique_providers, unique_queries

Summary:

FieldDescription
by_keywordEach keyword with total_count and avg_count
by_providerEach provider with total_keyword_appearances

Data rows:

FieldTypeDescription
datestringTimestamp
providerstringAI provider
query_textstringThe tracked query
keywordstringThe keyword
countnumberOccurrence count

Try asking:

  • "What keywords come up most in AI answers about my brand?"
  • "Which terms do AI providers associate with my queries?"
  • "Show keyword frequency differences between ChatGPT and Gemini"

Example response:

Top keywords in AI responses for your tracked queries this week:

KeywordCountTop Provider
affordable34ChatGPT
enterprise28Gemini
open-source22Perplexity
scalable19ChatGPT

"Affordable" is the most common keyword — AI models are framing your space around pricing. If you want to shift the narrative toward quality or features, this is useful input for your content strategy.