# Understanding Chats
Source: https://help.mentionpilot.ai/Interpreter/understanding-chats

The foundation of all your analytics

***

Every time your prompts run across platforms like ChatGPT, Gemini, AI Overviews, and Perplexity AI, we capture the generated response. These responses are what we call chats.

All your metrics — visibility, position, sentiment, and even source analysis — are derived from these chats. That’s why it’s important not to skip this layer and rely only on aggregated data.

Each chat represents what a real user would see when they ask a similar question. Reviewing chats regularly helps you understand not just whether your brand appears, but how and why it appears.

***

## Anatomy of a chat

<Card title="What each chat includes" icon="layer-group">
  Each chat contains multiple elements that contribute to your analysis:
</Card>

* Response content: The full AI-generated answer. This is the most important part because it shows how your brand is positioned in context.
* Brands mentioned: A list of all brands referenced in the response, including your own and competitors.
* Position: The order in which your brand appears. Being mentioned earlier generally indicates higher authority and relevance.
* Sentiment: The tone used when referencing your brand — whether it is positive, neutral, or negative.
* Platform and context: The AI model used and the environment in which the response was generated.
* Sources: The URLs and domains that influenced the response.

***

One important detail to keep in mind is that your position is calculated against all brands mentioned in the response, not just the competitors you have added. This gives you a more realistic picture of where you stand in the broader AI-generated landscape.

***

## Sources vs citations

<Card title="Important distinction" icon="link">
  Not all sources are visible in the response.
</Card>

* Citations are the sources explicitly referenced in the answer.
* Sources include all content the AI used to generate the response, even if not directly shown.

Both are important. Citations influence visibility and user trust, while background sources influence how AI understands your brand and category.

***

## How to approach chat analysis

Instead of focusing on individual responses, it’s better to look for patterns over time. AI outputs can vary slightly day to day, but consistent trends are what matter.

When reviewing chats, try to identify:

* Which competitors appear most frequently
* Whether your brand is consistently included or missing
* How your brand is described compared to others
* Which types of sources are being used

***

<Card title="Next → Understanding Your Performance" icon="arrow-right" href="understanding-performance">
  Learn how chats translate into metrics and trends.
</Card>


# Understanding Your Performance
Source: https://help.mentionpilot.ai/Interpreter/understanding-performance

Reading your dashboard with context

***

Your dashboard is essentially a summarized view of all the chats generated from your prompts. It aggregates individual responses into metrics that help you track trends over time.

Instead of treating each metric separately, it’s important to understand how they work together.

***

## Core performance areas

***

### Visibility

Visibility measures how often your brand appears across all AI responses.

A higher visibility score means your brand is frequently included in relevant conversations, while a lower score indicates gaps in your presence.

***

### When analyzing visibility, focus on:

* Trends over time rather than daily changes
* Comparison with competitors
* Specific prompts or topics where visibility is weak

***

### Position

Position reflects where your brand appears within responses when it is mentioned.

Being listed first or early in a response generally leads to higher impact, as users tend to trust and engage with the first few recommendations.

***

### Position helps you understand:

* Your authority relative to competitors
* Which topics you dominate
* Where you appear but lack prominence

***

### Sentiment

Sentiment shows how AI models describe your brand.

A neutral sentiment often means your brand is included but not strongly endorsed. Positive sentiment indicates strong positioning, while negative sentiment may highlight perception issues.

***

### When interpreting sentiment:

* Look at overall trends rather than isolated cases
* Compare sentiment across platforms
* Identify patterns in how competitors are described

***

### Recent chats

<Card title="Connect metrics to reality" icon="message">
  The Recent Chats section connects your metrics to real responses.
</Card>

Whenever you notice a change in visibility, position, or sentiment, reviewing recent chats will help you understand what caused that change.

***

### Using filters effectively

Your dashboard includes filters for:

* AI platforms
* Date ranges

***

These allow you to focus your analysis on specific scenarios.

For example:

* Comparing performance across platforms
* Analyzing trends over a specific time period
* Understanding how you perform against a particular competitor

***

<Card title="Next → Understanding Sources" icon="arrow-right" href="understanding-sources">
  Learn what drives your visibility and why AI includes your brand.
</Card>


# Understanding sources
Source: https://help.mentionpilot.ai/Interpreter/understanding-sources

The driving force behind AI visibility

***

Sources are one of the most important parts of AI visibility tracking.

While you cannot directly control AI models, you can influence the content they rely on. Sources represent the websites and pages that AI uses to generate responses.

***

## Why sources matter

Sources determine:

* Whether your brand is included in responses
* How frequently you appear
* How strongly you are positioned

***

A stronger presence across trusted sources increases your chances of being recognized and recommended by AI models.

***

## How to analyze sources

When reviewing source data, focus on:

* Frequently appearing domains
* Sources where competitors are present but you are not
* Sources where your content is already being used

***

This helps you identify both strengths and opportunities.

***

## Practical insights from sources

Source analysis can reveal:

* Which publications influence your industry
* What type of content AI prefers
* Where you need to improve your presence

***

## Sources Breakdown: Domains vs URLs

<Card title="Key distinction" icon="layer-group">
  MentionPilot breaks source data into two levels to help you analyze it more effectively.
</Card>

***

### Domains

Domains represent the overall websites that AI models rely on.

This helps you identify:

* Trusted platforms in your industry
* Where competitors are gaining visibility
* Where you need to build presence

***

### Domains are categorized into:

* Editorial (blogs, news sites)
* Corporate (company websites)
* User-generated content (forums, communities)
* Reference (documentation, encyclopedias)

***

### URLs

URLs go one level deeper and show the specific pages used as sources.

This helps you understand not just where content is coming from, but what type of content is working.

***

### Common URL types include:

* Articles and guides
* Listicles and rankings
* Comparison pages
* Product or service pages

***

## Why this distinction matters

<Card title="Simple way to think about it" icon="brain">
  Domains tell you where to focus.\
  URLs tell you what to create.
</Card>

***

By combining both, you can:

* Identify high-performing content formats
* Understand why competitors are being mentioned
* Build content that aligns with what AI models prefer

***

## Final takeaway

<Card title="Big picture" icon="sparkles">
  Chats show what AI is saying

  Performance metrics show how often and how well you appear

  Sources explain why you appear
</Card>

***

## A practical way to approach this

Instead of analyzing everything at once:

* Start by reviewing chats
* Then look at visibility and position trends
* Finally, analyze sources to understand the “why”

***

This approach keeps your analysis focused and actionable.


# Billing
Source: https://help.mentionpilot.ai/account/billing

Manage your plan, usage, and upgrades

***

The Billing section in MentionPilot is where you can view your current subscription, understand your usage limits, and upgrade your plan as your tracking needs grow.

Whether you're just getting started or scaling your AI visibility tracking across multiple brands and prompts, this section gives you full control over your plan.

***

## Overview

<Card title="Your Billing Snapshot" icon="chart-bar">
  When you navigate to Billing, you’ll see a complete snapshot of your current plan, including:
</Card>

* Your active subscription plan
* Prompt limits based on your plan
* Billing cycle (monthly or yearly)
* Renewal date
* Current usage

This helps you quickly understand how much of your plan you’re using and whether you need to scale.

***

## Understanding your plan limits

<Card title="Plan Limits" icon="gauge">
  Each plan in MentionPilot comes with specific limits, primarily around:
</Card>

* Number of active prompts you can track
* Number of brands you can manage
* Access to advanced features (like audit reports, exports, etc.)

As your usage grows, especially if you’re tracking multiple prompts across platforms like ChatGPT, Gemini, AI Overviews, and Perplexity AI, you may reach your plan limits.

Instead of restricting your workflow, MentionPilot allows you to easily upgrade when needed.

***

## Upgrading your plan

<Card title="Upgrade Options" icon="arrow-up">
  Upgrading your plan is straightforward.
</Card>

From the Billing page, you can:

* View all available plans
* Compare features and limits
* Select the plan that fits your needs
* Upgrade instantly

Once upgraded, your new limits and features are applied immediately, allowing you to continue tracking without interruption.

***

## When should you upgrade?

<Columns>
  <Card title="Growth Signals">
    You’ve reached your prompt limit and want to track more queries

    You’re adding more brands or competitors
  </Card>

  <Card title="Scaling Needs">
    You need deeper analysis across multiple AI platforms

    You want to scale tracking for teams or multiple projects
  </Card>
</Columns>

***

## Billing transparency

<Card title="Transparency" icon="eye">
  MentionPilot is designed to keep billing simple and transparent.
</Card>

You can always:

* See exactly what you’re paying for
* Track your usage against limits
* Upgrade without losing existing data

***

## Best practice

<Card title="Recommendation" icon="lightbulb">
  Start with a plan that matches your current needs but keep an eye on your prompt usage.
</Card>

AI visibility tracking becomes more valuable as you expand your prompts — so upgrading is often a natural step as you grow.


# Teams
Source: https://help.mentionpilot.ai/account/teams

Collaborate with your team and manage access

***

The Teams feature in MentionPilot is designed for agencies, marketing teams, and businesses that want to manage AI visibility tracking collaboratively.

Instead of working alone, you can invite team members, assign responsibilities, and give access to specific brands — all within one centralized workspace.

***

## Overview

<Columns>
  <Card title="Invite & Collaborate">
    Invite team members to your workspace

    Collaborate on tracking and analysis
  </Card>

  <Card title="Control Access">
    Assign brands to specific users

    Control who has access to what
  </Card>
</Columns>

This is especially useful if you’re managing multiple brands, clients, or internal teams.

***

## Inviting team members

<Card title="Invite Users" icon="user-plus">
  Adding team members is simple.
</Card>

From the Teams section, you can:

* Enter the email address of the person you want to invite
* Send an invitation directly from the platform
* Allow them to join your workspace once accepted

This makes onboarding quick and seamless.

***

## Assigning brands to team members

<Card title="Brand-Level Access" icon="layer-group">
  One of the most important features of Teams is brand-level access control.
</Card>

Instead of giving everyone access to everything, you can:

* Assign specific brands to specific users
* Limit access based on roles or responsibilities
* Ensure each team member focuses only on relevant data

***

### Example

<Columns>
  <Card title="Specialist">
    A team member managing SEO for one brand only sees that brand’s data
  </Card>

  <Card title="Account Manager">
    An account manager can access multiple brands
  </Card>

  <Card title="Admin / Founder">
    A founder or admin can view everything
  </Card>
</Columns>

***

## Managing team access

<Card title="Access Control" icon="users">
  As your team grows, you can manage users easily:
</Card>

* Add or remove members anytime
* Update access based on changing roles
* Reassign brands as needed

This keeps your workspace organized and secure.

***

## Why Teams matter

<Card title="Collaboration" icon="network-wired">
  AI visibility tracking often involves multiple stakeholders:
</Card>

* SEO teams
* Content teams
* PR teams
* Founders or decision-makers

***

The Teams feature ensures everyone can:

* Access the right data
* Work independently
* Stay aligned on insights

***

## Best practice

<Card title="Recommendation" icon="lightbulb">
  Keep access structured.
</Card>

Instead of giving full access to everyone:

* Assign brands based on responsibility
* Keep ownership clear
* Review access regularly as your team evolves

***

## Final note

<Card title="Scaling" icon="arrow-trend-up">
  As you scale your usage of MentionPilot, Teams becomes essential.
</Card>

It helps you move from: individual tracking to structured, collaborative AI visibility management


# Authentication
Source: https://help.mentionpilot.ai/api-reference/authentication

How to authenticate with the MentionPilot API

All API requests must be authenticated using an API key passed as a Bearer token in the `Authorization` header.

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

***

## Generate an API key

Go to your API Keys page to create a key:

<Card title="API Keys" icon="key" href="https://app.mentionpilot.ai/api-keys">
  Generate and manage your API keys
</Card>

1. Click **Create new key**
2. Give it a name so you can identify it later
3. Choose the key type — **Global** or **Brand-scoped**
4. Copy the key immediately — it won't be shown again

***

## Key types

<CardGroup>
  <Card title="Global key" icon="globe">
    Access all brands and data in your account.

    Use this for server-side integrations where you need full access.
  </Card>

  <Card title="Brand-scoped key" icon="building">
    Restricted to a single brand.

    Use this when you want to limit access — for example, sharing data with a specific client or team.
  </Card>
</CardGroup>

***

## Example request

```bash theme={null}
curl -X POST https://app.mentionpilot.ai/api/v1/brand-report \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "brand_id": 1 }'
```

***

## Security guidelines

* Never expose your API key in client-side code or public repositories
* Rotate keys regularly and revoke any that are no longer in use
* Use brand-scoped keys wherever full account access is not needed
* If a key is compromised, delete it immediately from the [API Keys page](https://app.mentionpilot.ai/api-keys) and generate a new one

***

## Error responses

| Status | Meaning                                                                           |
| ------ | --------------------------------------------------------------------------------- |
| `401`  | Missing or invalid API key                                                        |
| `403`  | Key does not have access to the requested resource (brand-scoped key restriction) |


# Brand Report
Source: https://help.mentionpilot.ai/api-reference/endpoint/brand-report

POST /brand-report
Returns aggregated visibility, sentiment, and position metrics across all prompts under a brand.



# Create Brand
Source: https://help.mentionpilot.ai/api-reference/endpoint/create

POST /brand
Creates a new brand under your account.



# Delete Brand
Source: https://help.mentionpilot.ai/api-reference/endpoint/delete

DELETE /brand
Deletes a brand from your account by its ID.



# Get Brands
Source: https://help.mentionpilot.ai/api-reference/endpoint/get

GET /brand
Returns all brands associated with your account.



# Get Prompts
Source: https://help.mentionpilot.ai/api-reference/endpoint/get-prompts

POST /prompt
Returns prompts for a specific brand. Supports optional date range filtering and result limiting.



# Get Sources
Source: https://help.mentionpilot.ai/api-reference/endpoint/get-sources

POST /sources
Returns sources for a specific brand. Supports optional date range filtering and result limiting.



# Prompt Report
Source: https://help.mentionpilot.ai/api-reference/endpoint/prompt-report

POST /prompt-report
Returns visibility, sentiment, and position metrics per prompt. Pass `prompt_id` for a single prompt, or omit to return all prompts across all brands.



# Toggle Prompt Status
Source: https://help.mentionpilot.ai/api-reference/endpoint/toggle-prompt

PATCH /prompt
Toggles a prompt between active (Y) and inactive (N).



# Tracked Competitors
Source: https://help.mentionpilot.ai/api-reference/endpoint/tracked-competitors

POST /competitor/tracked
Returns tracked competitors for a brand with visibility, sentiment, and position metrics aggregated across all brand prompts.



# Untracked Competitors
Source: https://help.mentionpilot.ai/api-reference/endpoint/untracked-competitors

POST /competitor/untracked
Returns untracked competitors for a brand with visibility only, aggregated across all brand prompts.



# Introduction
Source: https://help.mentionpilot.ai/api-reference/introduction

Programmatic access to your AI brand visibility data

The MentionPilot API lets you access everything in your account programmatically — brands, prompts, competitors, sources, and visibility reports.

Use it to pull data into your own dashboards, automate reporting, or build custom integrations.

***

## Base URL

All API requests go to:

```
https://app.mentionpilot.ai/api/v1
```

***

## Authentication

Every request requires a Bearer token. See the [Authentication](/api-reference/authentication) page for how to generate and use API keys.

***

## Request format

All endpoints accept JSON in the request body. Set the `Content-Type` header accordingly.

```bash theme={null}
Content-Type: application/json
```

***

## What you can do

<CardGroup>
  <Card title="Brand" icon="building">
    Get, create, and delete brands. Fetch aggregated visibility, sentiment, and position metrics for a brand.
  </Card>

  <Card title="Prompt" icon="message">
    List prompts, toggle active status, and fetch per-prompt visibility metrics with sentiment and position breakdowns.
  </Card>

  <Card title="Competitor" icon="users">
    Retrieve tracked competitors with full metrics, or untracked competitors with visibility-only data.
  </Card>

  <Card title="Sources" icon="link">
    Fetch the web sources AI platforms used when generating responses for your prompts.
  </Card>
</CardGroup>

***

## Response format

All responses return JSON. Successful responses include `"success": true`.

```json theme={null}
{
  "success": true,
  ...
}
```

Errors include `"success": false` and an `"error"` message.

```json theme={null}
{
  "success": false,
  "error": "brand_id is required"
}
```

***

## HTTP status codes

| Code  | Meaning                                       |
| ----- | --------------------------------------------- |
| `200` | Success                                       |
| `400` | Invalid request — check your parameters       |
| `401` | Missing or invalid API key                    |
| `403` | Your key doesn't have access to this resource |
| `404` | Resource not found                            |
| `500` | Server error                                  |

All endpoints accept JSON in the request body. Set the `Content-Type` header accordingly.

```bash theme={null}
Content-Type: application/json
```

***

## What you can do

<CardGroup>
  <Card title="Brand" icon="building">
    Get, create, and delete brands. Fetch aggregated visibility, sentiment, and position metrics for a brand.
  </Card>

  <Card title="Prompt" icon="message">
    List prompts, toggle active status, and fetch per-prompt visibility metrics with sentiment and position breakdowns.
  </Card>

  <Card title="Competitor" icon="users">
    Retrieve tracked competitors with full metrics, or untracked competitors with visibility-only data.
  </Card>

  <Card title="Sources" icon="link">
    Fetch the web sources AI platforms used when generating responses for your prompts.
  </Card>
</CardGroup>

***

## Response format

All responses return JSON. Successful responses include `"success": true`.

```json theme={null}
{
  "success": true,
  ...
}
```

Errors include `"success": false` and an `"error"` message.

```json theme={null}
{
  "success": false,
  "error": "brand_id is required"
}
```

***

## HTTP status codes

| Code  | Meaning                                       |
| ----- | --------------------------------------------- |
| `200` | Success                                       |
| `400` | Invalid request — check your parameters       |
| `401` | Missing or invalid API key                    |
| `403` | Your key doesn't have access to this resource |
| `404` | Resource not found                            |
| `500` | Server error                                  |


# Welcome to MentionPilot
Source: https://help.mentionpilot.ai/index

The AI Visibility Platform for Modern Search, Chat, and Answer Engines

***

Your audience isn’t discovering brands the way they used to.

They’re no longer just typing keywords into Google and browsing links.

***

## Instead, they are:

<Columns>
  <Card title="AI Overviews" icon="globe">
    Seeing direct answers inside AI Overviews
  </Card>

  <Card title="ChatGPT & Gemini" icon="message">
    Asking ChatGPT and Gemini for recommendations
  </Card>

  <Card title="Perplexity AI" icon="search">
    Using Perplexity AI to research, compare, and validate decisions
  </Card>
</Columns>

***

People are having conversations with AI instead of searching with keywords.

This fundamentally changes how visibility works.

Your brand is no longer competing for rankings.

You are competing to be included, recommended, and trusted inside AI-generated answers.

MentionPilot shows you exactly how your brand appears across these AI platforms — and what you can do to improve your visibility.

***

## What You’ll Find in These Docs

<Card title="Documentation Overview" icon="book-open">
  These docs are designed to help you go from zero understanding of AI visibility → to actionable growth strategy.

  Each section builds on the previous one, so you can move from setup to insights to execution without confusion.
</Card>

***

## Get Started

<Card title="Learn the Fundamentals" icon="lightbulb">
  We begin by helping you understand the fundamentals.
</Card>

You’ll learn:

* What AI visibility actually means
* How it differs from traditional SEO
* What we track and why it matters
* How to get your first meaningful insights within your first week

<Card title="Quickstart Guide" icon="rocket">
  You’ll also go through a step-by-step quickstart guide that walks you through:
</Card>

* Creating your first project
* Adding prompts that reflect real user behavior
* Identifying relevant competitors
* Understanding your initial data

***

## Set Up Your Tracking System

<Card title="Build Your Tracking Foundation" icon="gear">
  Once you understand the basics, the next step is building your tracking foundation.
</Card>

In this section, you’ll learn how to:

* Create high-quality prompts based on real conversations
* Structure your prompts using topics and categories
* Choose the right competitors (direct, indirect, and emerging AI-native players)
* Build a system that generates meaningful and consistent data

This is one of the most important parts of using MentionPilot effectively.

The quality of your setup directly impacts the quality of your insights.

***

## Interpret Your Results

<Card title="Understand Your Data" icon="chart-line">
  After your prompts start running, you’ll begin to see data across platforms.
</Card>

This section helps you make sense of it.

You’ll learn how to:

* Understand visibility trends over time
* Analyze your position in AI-generated responses
* Evaluate sentiment and how AI describes your brand
* Break down performance across different AI platforms
* Read prompt-level insights and identify patterns

We go beyond surface-level metrics and help you focus on what actually drives growth.

***

## Take Action

<Card title="Turn Insights Into Growth" icon="bolt">
  Data without action has no value.
</Card>

This section is where MentionPilot becomes a growth tool, not just an analytics platform.

You’ll learn how to:

* Identify content gaps where competitors are winning
* Discover which sources influence AI responses in your category
* Find opportunities to increase brand mentions
* Improve your authority and presence across AI platforms
* Build strategies tailored to each AI ecosystem

***

## Additional Resources

<Card title="Explore More" icon="book">
  For quick access and deeper understanding, you’ll also find:
</Card>

* Metric definitions
* Platform walkthroughs
* Best practices and examples
* Short guides for specific features

If you need fast answers or want to explore specific features, this section is your shortcut.

***

## What MentionPilot Tracks

<Card title="Core Metrics" icon="chart-bar">
  MentionPilot tracks how your brand appears when users ask AI platforms questions related to your industry.
</Card>

Instead of traditional rankings, we focus on three core metrics that define AI visibility.

***

<Columns>
  <Card title="Visibility" icon="eye">
    Visibility measures how often your brand is mentioned across AI-generated responses.
  </Card>

  <Card title="Position" icon="list-ol">
    Position measures where your brand appears within AI responses when it is mentioned.
  </Card>

  <Card title="Sentiment" icon="face-smile">
    Sentiment measures how AI platforms describe your brand when they mention it.
  </Card>
</Columns>

***

## The Shift You Need to Understand

<Columns>
  <Card title="Old World" icon="clock">
    Rankings\
    Keywords\
    Clicks
  </Card>

  <Card title="New World" icon="sparkles">
    Mentions\
    Recommendations\
    AI-generated answers
  </Card>
</Columns>

👉 If your brand is not part of AI answers, you are invisible — even if you rank on Google.

***

## What to Do Next

<Card title="Start with Quick Start Guide" icon="rocket" href="/quickstart">
  Start with the Quick Start Guide.
</Card>

Within your first week, you’ll be able to:

* Understand your current AI visibility
* Identify gaps
* Spot competitor advantages
* Discover actionable opportunities

***

## Final Thought

<Card title="The Future of Search" icon="trending-up">
  Most companies are still optimizing for yesterday’s search.

  The next wave of growth belongs to those who understand how AI decides what to recommend.

  MentionPilot gives you that visibility.
</Card>


# Looker Studio Connector
Source: https://help.mentionpilot.ai/integrations/looker-studio

Import your MentionPilot AI visibility data into Google Looker Studio and build custom dashboards and reports.

## What is the MentionPilot Looker Studio connector?

The MentionPilot Looker Studio community connector lets you import your AI search visibility data directly into [Google Looker Studio](https://lookerstudio.google.com/). You can then create custom dashboards and reports using your brand performance data from AI search engines like ChatGPT, Perplexity, and Gemini.

<Note>
  Looker Studio is Google's free data visualization tool that helps you turn your data into informative, easy-to-read, and shareable dashboards and reports.
</Note>

### How this helps

* **Real-time data access** — Connect directly to your MentionPilot project for up-to-date visibility metrics.
* **Custom visualizations** — Create charts, graphs, and tables that match your reporting needs.
* **Team collaboration** — Share dashboards with stakeholders and team members.

***

## How to set up the connector

### What you need

Before you begin, ensure you have:

* A MentionPilot account with access to at least one project
* A Google account with access to Looker Studio

***

### Step 1: Access the connector

1. Use [this link](https://datastudio.google.com/datasources/create?connectorId=AKfycbxsJnXvf6x50ubEkAVXee9qbP--znoJvfm9N5JCMp0YkMxUyJUGRAc-QWg_HHAj2ZEQ\&authuser=0) to access the MentionPilot connector in Looker Studio (make sure you're signed in with your Google account).
2. Enter your basic info and complete account setup.

<Warning>
  If you can't find the MentionPilot connector in the gallery or encounter other issues, contact us at [support@mentionpilot.raiseaticket.com](mailto:support@mentionpilot.raiseaticket.com).
</Warning>

***

### Step 2: Authorize the connection

1. Click **AUTHORIZE** to begin the OAuth2 authentication process.
2. You'll be redirected to Google's authorization page.
3. Sign in with your Google account if prompted.
4. You'll see a "Google hasn't verified this app" warning. This is normal for community connectors. Click **Advanced → Go to MentionPilot (unsafe)**.
5. Grant the necessary permissions to the connector.
6. You'll be redirected back to Looker Studio once authorization is complete. Another **AUTHORIZE** button will appear below "MentionPilot requires authorization to connect to data."
7. Click **AUTHORIZE** again.
8. You will see a MentionPilot Looker Authenticator pop-up. Click **Continue with Google** and sign in or select your Google account.
9. Once prompted, close the window and return to the Looker Studio page.

***

### Step 3: Configure your data source

After authorization, you'll see the connector configuration screen:

1. Choose which **MentionPilot Project** to connect.
2. If you want to create reports that can switch between multiple MentionPilot projects, select the option to use **Projects as a parameter** in reports.

***

### Step 4: Connect and validate

1. Click **CONNECT** to establish the connection.
2. The connector will validate your configuration and fetch sample data.
3. You'll see the available fields that can be used in your reports.

***

## Available data fields

### Dimensions

| Field          | Type | Description                                                          |
| -------------- | ---- | -------------------------------------------------------------------- |
| Brand          | Text | All the brands that you have added in MentionPilot                   |
| Source: Domain | Text | The website domains that AI models used while answering your prompts |
| Date           | Date | Date for all the metrics                                             |

### Metrics

| Field      | Type   | Description                                                |
| ---------- | ------ | ---------------------------------------------------------- |
| Visibility | Number | Visibility score for brands on the specific date           |
| Citations  | Number | Citation count for the source domain on the specified date |
| Chats      | Number | Number of chats on the specified date                      |

***

## Creating your first report

### Step 1: Create a new report

1. After configuring your data source, click **CREATE REPORT**.
2. Looker Studio will open the report editor with your MentionPilot data source connected.

### Step 2: Add visualizations

Looker Studio offers a wide range of charts and tables to fit your needs. See [Types of Charts in Looker Studio](https://cloud.google.com/looker/docs/studio/types-of-charts-in-looker-studio) for all available options.

Recommended starting points:

* **Time series chart** — Track your Visibility score over time.
* **Bar chart** — Compare brand visibility across AI models.
* **Table** — Show a detailed breakdown of citations by source domain.

### Step 3: Apply filters and controls

Add interactive controls to make your reports dynamic:

* **Date range control** — Let viewers adjust the time window.
* **Brand filter** — Drill into a specific brand's performance.
* **Source domain filter** — Focus on citations from a particular domain.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authorization Failed">
    * Ensure you're using the correct Google account.
    * Clear your browser cache and try again.
    * Check that your account has access to the MentionPilot project.
  </Accordion>

  <Accordion title="No Data Available">
    * Verify you've selected the correct MentionPilot project.
    * Check that your date range includes data (data appears after 24–48 hours).
    * Ensure your filters aren't too restrictive.
  </Accordion>

  <Accordion title="Connection Timeout">
    * Try reducing the date range.
    * Remove unnecessary filters.
    * Contact support if the issue persists.
  </Accordion>

  <Accordion title="Invalid Project">
    * Double-check your project selection in the MentionPilot dashboard.
    * Ensure you have access permissions to the project.
    * Contact your account administrator if needed.
  </Accordion>
</AccordionGroup>

### Getting help

If you encounter issues not covered above, contact support:

* **Email**: [support@mentionpilot.raiseaticket.com](mailto:support@mentionpilot.raiseaticket.com) — include a description of the issue and screenshots if applicable.


# Main metrics
Source: https://help.mentionpilot.ai/main_metrics

The three numbers that define your AI visibility

***

<p>
  MentionPilot focuses on three core metrics:
</p>

<Columns>
  <Card title="Visibility" icon="eye" />

  <Card title="Position" icon="list-ol" />

  <Card title="Mentions" icon="link" />
</Columns>

Together, these give you a clear picture of:

Where you appear, how often you appear, and why you appear.

***

## 1. Visibility

<Card title="How often your brand shows up in AI answers" icon="eye">
  How often your brand shows up in AI answers
</Card>

### What it means

Visibility tells you how frequently your brand is mentioned when AI platforms answer questions related to your industry.

In simple terms:

“Out of all the relevant AI responses, how many include my brand?”

***

### How it’s calculated

<Card title="Formula" icon="calculator">
  Visibility = (Responses mentioning your brand ÷ Total responses) × 100
</Card>

This gives you a percentage.

So, if your brand appears in 30 out of 100 responses, your visibility is 30%.

***

### How to read this metric

* High visibility → AI frequently recognizes your brand
* Low visibility → You’re missing from important conversations

***

### Why visibility matters

<Columns>
  <Card title="Share of AI answers">
    Instead of rankings, this is your new market share.
  </Card>

  <Card title="Brand awareness">
    It shows if AI even knows you exist
  </Card>

  <Card title="Find gaps">
    It highlights gaps quickly
  </Card>
</Columns>

You’ll start noticing things like:

“We show up for SEO topics but not for AI marketing”

“Competitors dominate certain queries”

That’s where your opportunities are.

***

### Practical example

If you’re tracking:

“Best SEO agencies for SaaS”

And your brand never appears → your visibility for that topic is 0%.

That’s a clear signal:\
You’re not part of that conversation yet.

***

## 2. Position

<Card title="Where your brand appears inside AI responses" icon="list-ol">
  Where your brand appears inside AI responses
</Card>

### What it means

Position tells you how early your brand is mentioned when it does appear.

Because not all mentions are equal.

***

### How it works

When AI generates an answer, it often lists multiple brands.

Example:

Brand A

Brand B

Your Brand

Your position here = 3

***

### How we calculate it

We take the average position across all responses where your brand appears.

***

### How to read this metric

* Closer to 1 → Strong authority (you’re mentioned first)
* Higher number → Lower visibility impact

***

### Why position matters

<Columns>
  <Card title="Maximum attention">
    First mention = maximum attention
  </Card>

  <Card title="Authority signal">
    It reflects perceived authority
  </Card>

  <Card title="Topic strength">
    It shows topic-level strength
  </Card>
</Columns>

You might notice:

Position 1–2 for SEO topics

Position 4–5 for AI topics

That tells you exactly where you’re strong vs weak.

***

### Practical example

Two brands can have the same visibility:

Brand A → always position 1

Brand B → always position 5

Brand A wins. Every time.

***

## 3. Mentions

<Card title="Where your brand exists across the web" icon="link">
  Where your brand exists across the web (and why AI picks you)
</Card>

### What it means

Mentions track where your brand appears across the internet, the sources that influence AI responses.

***

### This includes

* Blog articles
* News sites
* Industry publications
* Reviews
* Listings

***

### Why this metric is different

Visibility and Position tell you what is happening.

Mentions tell you why it’s happening.

***

### How it works

AI models don’t randomly pick brands.

They rely on content and references across the web.

***

### What to look for

<Columns>
  <Card title="Competitor sources">
    Where competitors are mentioned
  </Card>

  <Card title="Missing sources">
    Where you’re missing
  </Card>

  <Card title="Your presence">
    Where you already exist
  </Card>
</Columns>

***

### Why mentions matter

<Columns>
  <Card title="Visibility driver">
    They directly impact visibility
  </Card>

  <Card title="Position influence">
    They influence position
  </Card>

  <Card title="Perception">
    They shape perception
  </Card>
</Columns>

***

### Simple way to think about it

<Card title="Mental Model" icon="brain">
  Visibility → Are you showing up?

  Position → Are you showing up early?

  Mentions → Why are you showing up at all?
</Card>

***

## How These Metrics Work Together

You should never look at these in isolation.

<Columns>
  <Card title="Scenario 1">
    Low visibility + low mentions\
    → You’re not present enough online
  </Card>

  <Card title="Scenario 2">
    High visibility + low position\
    → You appear often, but not strongly
  </Card>

  <Card title="Scenario 3">
    High visibility + high position + strong mentions\
    → You dominate AI responses
  </Card>
</Columns>

***

## One Common Mistake

<Card title="Mistake" icon="triangle-exclamation">
  Most users only look at visibility.
</Card>

That’s not enough.

***

## What actually matters

<Card title="Reality" icon="bullseye">
  Visibility + Position + Mentions together
</Card>

That’s your real AI presence.

***

## Final takeaway

<Card title="Key Insight" icon="key">
  If you understand these three metrics, you understand your entire AI visibility strategy.

  Everything else in MentionPilot builds on top of this.
</Card>


# Introduction
Source: https://help.mentionpilot.ai/mcp/introduction

Connect MentionPilot AI visibility data directly to Claude.

<Note>
  The MentionPilot MCP Server is currently available for **Claude (claude.ai)** only. Support for additional AI clients is coming soon.
</Note>

## What is the MentionPilot MCP Server?

The MentionPilot MCP Server exposes your brand's AI visibility data through the **Model Context Protocol (MCP)** — an open standard that lets AI assistants like Claude read and reason over live data from external services.

Once connected, you can ask your AI assistant natural-language questions such as:

* *"How visible is my brand on ChatGPT this week?"*
* *"Which competitors are outranking me on Gemini?"*
* *"Give me a weekly summary I can paste into our Slack channel."*

Your assistant calls the MentionPilot MCP tools under the hood and returns real-time answers grounded in your actual data.

***

## How it works

```
Claude (claude.ai)  ──►  MentionPilot MCP Server  ──►  MentionPilot API
                         (mcp.mentionpilot.ai)         (app.mentionpilot.ai)
```

1. You connect your AI client to `https://mcp.mentionpilot.ai/mcp` once.
2. The server authenticates you via OAuth — your MentionPilot API key is exchanged securely and never stored client-side.
3. Your assistant discovers the available **tools** and calls them on demand.
4. Results are returned as structured text the assistant can read, summarize, or act on.

***

## Supported AI clients

| Client                       | Connection type          | Status      |
| ---------------------------- | ------------------------ | ----------- |
| Claude (claude.ai)           | Remote MCP — OAuth       | Available   |
| Cursor                       | Remote MCP — OAuth       | Coming soon |
| Other MCP-compatible clients | Streamable HTTP (`/mcp`) | Coming soon |

***

## Protocol details

The server implements the **MCP Streamable HTTP** transport (`2024-11-05`) and supports:

* `initialize` — handshake and capability negotiation
* `tools/list` — returns the full tool catalogue
* `tools/call` — executes a tool with the given arguments
* Batch JSON-RPC requests
* SSE streaming responses (`Accept: text/event-stream`)

Authentication uses **OAuth 2.0 Authorization Code** flow. The resulting access token is your MentionPilot API key, forwarded as a `Bearer` token on every tool call.


# Prompts
Source: https://help.mentionpilot.ai/mcp/prompts

Ready-to-use prompts for common MentionPilot workflows in Claude.

These are copy-paste prompts you can use in Claude once you have connected MentionPilot. Replace the placeholder brand ID with a real one from your account — run `list_brands` if you are not sure of your IDs.

***

## Getting started

**List all your brands**

```
List my MentionPilot brands.
```

**Find a brand ID**

```
Search my MentionPilot brands for one whose domain contains "acme.com".
```

***

## Visibility & performance

**Overall brand report**

```
Show me the brand report for brand ID {brand_id}.
```

**Filtered by AI platform**

```
Show me the brand report for brand ID {brand_id} on ChatGPT only.
```

```
How is brand ID {brand_id} performing on Perplexity and Gemini?
```

**Date-range report**

```
Show me the brand report for brand ID {brand_id} from 2025-04-01 to 2025-04-30.
```

**Weekly summary (ready to share)**

```
Give me a full visibility summary for brand ID {brand_id} for the last 7 days.
Format it so I can paste it into Slack.
```

***

## Prompts & keyword tracking

**List tracked prompts**

```
List all tracked prompts for brand ID {brand_id}.
```

**Full prompt performance report**

```
Show me the prompt performance report for brand ID {brand_id}.
Which prompts have the lowest visibility?
```

**Single prompt deep-dive**

```
Show me the prompt report for prompt ID {prompt_id}.
```

***

## Competitive intelligence

**Competitor overview**

```
Show me all competitors tracked for brand ID {brand_id}, ranked by visibility.
```

**Gap analysis**

```
Compare brand ID {brand_id} to its competitors.
Where is the biggest visibility gap and what might explain it?
```

***

## Sources & content strategy

**Top citation sources**

```
Which domains does AI cite most when mentioning brand ID {brand_id}?
```

**Content gap prompt**

```
Show me the citation sources for brand ID {brand_id}.
Which high-authority domains are NOT on the list that I should target?
```

***

## Reporting

**Monthly digest**

```
Generate a monthly visibility report for brand ID {brand_id}
for the period 2025-04-01 to 2025-04-30.
Include brand metrics, top 5 prompts, and competitor rankings.
```

**Executive summary**

```
Summarize brand ID {brand_id}'s AI visibility performance in 3 bullet points
suitable for a C-level update.
```


# Setup
Source: https://help.mentionpilot.ai/mcp/setup

Connect the MentionPilot MCP Server to Claude in under two minutes.

## Prerequisites

* A MentionPilot account with at least one brand configured

***

## Connect to Claude (claude.ai)

1. Open [claude.ai](https://claude.ai) and go to **Settings → Integrations**.

2. Click **Add integration**.

3. Enter the MCP Server URL:

   ```
   https://mcp.mentionpilot.ai/mcp
   ```

4. Claude will open the MentionPilot authorization page. Sign in with your MentionPilot account credentials and click **Connect**.

5. You will be redirected back to Claude. The integration now appears as **mentionpilot** in your integrations list.

You can now start a new conversation and ask Claude about your brand's AI visibility.

***

<Note>
  Support for Cursor and other MCP-compatible clients is coming soon.
</Note>

***

## Verify the connection

Ask your AI assistant:

> *"List my MentionPilot brands."*

If the connection is working, the assistant will call `list_brands` and return a list of your tracked brands with their IDs.


# Tools
Source: https://help.mentionpilot.ai/mcp/tools

Full reference for all MentionPilot MCP tools — inputs, outputs, and usage examples.

The MentionPilot MCP Server exposes **7 tools**. All tools are read-only (`readOnlyHint: true`) and require a valid API key passed as a Bearer token.

<Tip>
  Always call `list_brands` first to get the brand IDs required by the other tools.
</Tip>

***

## list\_brands

Returns all brands in your MentionPilot account.

**Inputs:** none

**Example output:**

```
Your MentionPilot brands (2 total):

• Acme Corp (ID: 42) — domain: acme.com — created: 2024-11-01
• Acme Labs (ID: 43) — domain: labs.acme.com — created: 2025-01-15
```

***

## brand\_report

Aggregated AI visibility, sentiment, and position metrics for a brand across all tracked prompts.

**Inputs:**

| Parameter   | Type      | Required | Description                                                         |
| ----------- | --------- | -------- | ------------------------------------------------------------------- |
| `brand_id`  | number    | Yes      | Brand ID from `list_brands`                                         |
| `date.from` | string    | No       | Start date (`YYYY-MM-DD`)                                           |
| `date.to`   | string    | No       | End date (`YYYY-MM-DD`)                                             |
| `ai_agent`  | string\[] | No       | Filter by platform: `chatgpt`, `gemini`, `perplexity`, `aioverview` |

**Example output:**

```
📊 Brand Report: Acme Corp

Visibility:       64% — how often your brand appears in AI answers
Sentiment:        71/100 — how positively AI describes your brand
Avg Position:     2.3 — where you appear in AI responses (lower = better)
Total Responses:  1,840 AI answers analyzed
```

***

## list\_prompts

Returns all tracked prompts for a brand, including their active/paused status.

**Inputs:**

| Parameter   | Type   | Required | Description                         |
| ----------- | ------ | -------- | ----------------------------------- |
| `brand_id`  | number | Yes      | Brand ID                            |
| `date.from` | string | No       | Start date                          |
| `date.to`   | string | No       | End date                            |
| `limit`     | number | No       | Maximum number of prompts to return |

**Example output:**

```
Tracked prompts for brand ID 42 (3):

• [ID: 101] ✅ "best CRM software for startups" — added 2024-11-01
• [ID: 102] ✅ "top tools for sales teams" — added 2024-11-01
• [ID: 103] ⏸️ "CRM alternatives to Salesforce" — added 2025-01-10
```

***

## prompt\_report

Visibility, sentiment, and position metrics broken down per tracked prompt.

**Inputs:**

| Parameter   | Type      | Required | Description                                     |
| ----------- | --------- | -------- | ----------------------------------------------- |
| `prompt_id` | number    | No       | Specific prompt ID — omit to return all prompts |
| `date.from` | string    | No       | Start date                                      |
| `date.to`   | string    | No       | End date                                        |
| `ai_agent`  | string\[] | No       | Filter by platform                              |
| `limit`     | number    | No       | Maximum results to return                       |

**Example output:**

```
Prompt Performance Report (2 prompts):

📝 "best CRM software for startups"
   Brand: Acme Corp | Responses: 620
   Visibility: 78% | Sentiment: 74/100 | Position: 1.8

📝 "top tools for sales teams"
   Brand: Acme Corp | Responses: 540
   Visibility: 55% | Sentiment: 68/100 | Position: 3.1
```

***

## competitor\_report

Visibility, sentiment, and position for all tracked competitors of a brand, ranked by visibility.

**Inputs:**

| Parameter  | Type   | Required | Description |
| ---------- | ------ | -------- | ----------- |
| `brand_id` | number | Yes      | Brand ID    |

**Example output:**

```
Competitor Intelligence for brand ID 42 (ranked by visibility):

1. Rival Inc (rival.io)
   Visibility: 82% | Sentiment: 69/100 | Position: 1.5 | Responses: 1,840

2. OtherCo (otherco.com)
   Visibility: 41% | Sentiment: 72/100 | Position: 3.9 | Responses: 1,840
```

***

## sources\_report

The web domains AI platforms cite when mentioning your brand — useful for PR targeting and content gap analysis.

**Inputs:**

| Parameter   | Type      | Required | Description               |
| ----------- | --------- | -------- | ------------------------- |
| `brand_id`  | number    | Yes      | Brand ID                  |
| `date.from` | string    | No       | Start date                |
| `date.to`   | string    | No       | End date                  |
| `ai_agent`  | string\[] | No       | Filter by platform        |
| `limit`     | number    | No       | Maximum sources to return |

**Example output:**

```
Citation Sources for brand ID 42 (38 total, 12 unique domains):

• g2.com — cited 14 times
• capterra.com — cited 9 times
• techcrunch.com — cited 6 times
• forbes.com — cited 4 times
```

***

## visibility\_summary

A full natural-language narrative of a brand's AI visibility performance — ideal for weekly reports, Slack updates, or executive briefings.

**Inputs:**

| Parameter   | Type      | Required | Description        |
| ----------- | --------- | -------- | ------------------ |
| `brand_id`  | number    | Yes      | Brand ID           |
| `date.from` | string    | No       | Start date         |
| `date.to`   | string    | No       | End date           |
| `ai_agent`  | string\[] | No       | Filter by platform |

This tool fetches the brand report, prompt report, and competitor report in parallel and composes a single cohesive summary. Use it when you need a human-readable overview rather than raw numbers.

***

## AI platform filter values

Use these values in the `ai_agent` array parameter:

| Value        | Platform            |
| ------------ | ------------------- |
| `chatgpt`    | ChatGPT (OpenAI)    |
| `gemini`     | Gemini (Google)     |
| `perplexity` | Perplexity AI       |
| `aioverview` | Google AI Overviews |


# Use cases
Source: https://help.mentionpilot.ai/mcp/use-cases

Common workflows you can run with the MentionPilot MCP Server and an AI assistant.

## Weekly visibility report

Ask your assistant for a ready-to-share summary of the past seven days.

> *"Give me a visibility summary for brand ID 42 for the last 7 days."*

The assistant calls `visibility_summary` and returns a natural-language report covering your visibility score, sentiment, average position, top-performing prompts, and the leading competitor — all in one message you can paste directly into Slack or email.

***

## Competitive benchmark

Understand where your brand stands relative to competitors across AI platforms.

> *"Show me the competitor report for brand ID 42. Rank them by visibility."*

The assistant calls `competitor_report` and returns each tracked competitor's visibility, sentiment score, average position, and total responses analyzed — already sorted by visibility, highest first.

***

## Platform deep-dive

Focus on a specific AI platform to see where you win or lose visibility.

> *"How is brand ID 42 performing on ChatGPT only?"*

Pass `ai_agent: ["chatgpt"]` via the `brand_report` tool. The same filter works for `gemini`, `perplexity`, and `aioverview`.

***

## Prompt-level diagnosis

Identify which tracked prompts drive visibility and which need attention.

> *"List all prompts for brand ID 42 and show me the report for each one."*

The assistant first calls `list_prompts` to get IDs, then `prompt_report` for each, and presents a breakdown of visibility, sentiment, and position per question.

***

## Source and PR targeting

Find the domains AI platforms cite most when mentioning your brand.

> *"What sources does AI cite when mentioning brand ID 42?"*

The assistant calls `sources_report` and returns a ranked list of domains by citation count. Use this to identify high-authority content worth building or earning links from.

***

## Date-range comparison

Compare performance across two time windows.

> *"Compare brand ID 42's visibility for March vs April 2025."*

Run `brand_report` twice with different `date` ranges (`from` / `to` in `YYYY-MM-DD` format) and ask the assistant to summarize the delta.

***

## Automated Slack digest (example)

You can integrate the MCP server into an automated workflow:

1. Schedule a daily or weekly trigger (e.g., n8n, Make, Zapier).
2. Call `POST https://mcp.mentionpilot.ai/mcp` with a `tools/call` request for `visibility_summary`.
3. Pass the response text directly to your Slack webhook.

No LLM needed for simple digests — the `visibility_summary` tool already returns a human-readable narrative.


# Audit Report
Source: https://help.mentionpilot.ai/project/audit_report

Generate a complete AI visibility analysis from your prompts

***

This is where MentionPilot moves from “tracking tool” to “decision-making tool”.

Instead of manually analyzing dashboards, you can generate a full report based on your prompts.

***

## What you can do here

<Columns>
  <Card title="Create report">
    Create an audit report from selected prompts
  </Card>

  <Card title="View & export">
    View the report inside the platform\
    Download it as a PDF
  </Card>

  <Card title="Share">
    Share it with your team or clients
  </Card>
</Columns>

***

## What the audit report includes

***

### 1. Visibility Analysis (Across Platforms)

You’ll see how your brand performs across:

* Gemini
* ChatGPT
* AI Overviews
* Perplexity AI

***

### What this tells you

* Where your brand is strongest
* Where you’re underperforming
* Which platforms matter most for your category

***

### 2. Prompt-Level Performance

You’ll see:

* Total prompts analyzed
* Brand mentions
* Prompt coverage
* Position
* Sentiment
* AI models where your brand appears

***

### Why these matters

This is where you move from guessing → to clarity.

***

### 3. Sentiment Analysis

This shows the overall tone AI uses when mentioning your brand.

Example:

* 0% positive
* 100% neutral
* 0% negative

***

### How to interpret this

* Neutral → you’re being mentioned, but not strongly recommended
* Positive → strong brand positioning
* Negative → potential perception issues

***

### What to do with this

If sentiment is mostly neutral:\
You likely need stronger authority signals, not just more mentions

***

### 4. Sources Analysis

This section explains where AI is getting its information from

You’ll see:

* Total sources
* Unique domains
* Source types

***

### Source types include

* Informational
* Commercial
* Transactional

***

### Why these matters

<Card title="Key Insight" icon="link">
  “Which platforms are influencing AI responses in my industry?”
</Card>

***

### 5. Detailed Competitor Analysis

You’ll see:

* Visibility comparison
* Position comparison
* Sentiment comparison

***

### What you can learn

* Who dominates AI conversations
* Where competitors outperform you
* Where you have an advantage

***

## When to use the audit report

* Planning your content strategy
* Reporting to clients or stakeholders
* Reviewing performance over time

***

## Final takeaway

<Card title="Mental Model" icon="brain">
  User Profile → controls your account and limits

  Brand Profile → controls who you’re tracking

  Audit Report → turns your data into insights
</Card>


# Brand Profile
Source: https://help.mentionpilot.ai/project/brand_profile

Control which brands you track and compare

***

This section is where you manage all brands inside your project.

That includes:

* Your own brand
* Any additional brands you want to monitor

***

## What you can do here

***

### Add a brand

You can manually add any brand you want to track.

When adding a brand, you typically define:

* Brand name (how it appears in your dashboard)

Keep it simple and clean.

Example:

Use “HubSpot” instead of “HubSpot Inc.”

***

### Delete a brand

If a brand is no longer relevant:

* You can remove it from your project

This helps keep your data focused and easier to read.

***

### View brand-level insights

For each brand, you’ll be able to see:

* How many prompts it appears in
* How frequently it gets mentioned
* Its presence across your tracked conversations

***

### Brand vs prompts connection

Each brand is tied to your prompts.

That means:

* A brand only shows data if it appears in your tracked prompts
* More relevant prompts = better visibility insights

***

## Why this section matters

<Card title="Insight" icon="chart-line">
  Your competitor setup defines how meaningful your insights are.
</Card>

***

### Example

If you track weak or irrelevant competitors:

* Your data will look misleading

If you track strong, real competitors:

* You’ll clearly see gaps and opportunities

***

### Practical advice

<Card title="Tip" icon="lightbulb">
  Start simple:

  Add 3–5 competitors

  Expand later once you understand your data better
</Card>

***

<Card title="Next → Audit Report" icon="arrow-right" href="audit_report">
  Generate insights and reports from your data.
</Card>


# Manage Your Setup
Source: https://help.mentionpilot.ai/project/manage_your_setup

Refine prompts, competitors, and get better insights over time

***

## Managing your prompts (don’t ignore this)

As you add more prompts, you’ll probably realize:

Some are useful. Some are not.

That’s completely normal.

***

### You can deactivate prompts

<Card title="Deactivate" icon="toggle-off">
  If a prompt isn’t relevant anymore, you don’t have to delete it.
</Card>

* It stops tracking
* It doesn’t count toward your plan
* You can bring it back anytime

***

### You can reactivate later

If something becomes relevant again, just turn it back on.

Your tracking continues from there.

***

### You can export everything

<Card title="Export" icon="download">
  If you want to audit or share your setup:
</Card>

You can export your prompts as a CSV.

Simple but useful.

***

## Now add competitors (this gives your data meaning)

<Card title="Competitors" icon="users">
  Once your prompts are running, you’ll start seeing other brands show up in responses.
</Card>

***

### Why these matters

Without competitors, your data is just numbers.

With competitors, it becomes context.

Example:

You have 25% visibility.

Sounds decent.

But then you see a competitor at 60%.

Now you know there’s a gap and it’s not small.

***

### How to add competitors

Go to the Brands section and add a few manually.

Start simple.

3 to 5 competitors are enough in the beginning.

***

### One small but important detail

<Card title="Tip" icon="lightbulb">
  Use the name people actually use.
</Card>

“HubSpot” works

“hubspot.com” doesn’t

We’re tracking how AI mentions brands in conversation, not URLs.

***

### If a brand has variations

Sometimes brands are mentioned in different ways.

You can add those as aliases, so nothing gets missed.

***

## What happens after setup

<Card title="Automation" icon="gear">
  Once your prompts and competitors are in place, you don’t need to keep doing things every day.
</Card>

MentionPilot keeps running everything in the background.

Within a couple of days, you’ll start noticing patterns like:

* certain competitors showing up everywhere
* certain prompts where you’re completely missing
* some topics where you’re actually strong

***

## One honest piece of advice

<Card title="Advice" icon="triangle-exclamation">
  Don’t try to make this perfect on day one.
</Card>

Start with:

* 10–15 solid prompts
* a few real competitors

Let it run.

Then come back and refine.

***

## Final thought

If you get this setup right, everything else becomes easier.

Your dashboard makes sense.\
Your insights are clear.\
Your actions become obvious.

If you rush it, everything feels confusing.

***

## What to do next

<Card title="Next Step → Dashboard & Sources" icon="arrow-right">
  Once your project is set up:
</Card>

* let the data run for a bit
* then move to understanding your dashboard and sources

That’s where things start getting interesting.


# Set Up Your Project
Source: https://help.mentionpilot.ai/project/set_up_your_project

How to set up MentionPilot so your data actually makes sense

***

This is the part most people rush through.

And then a few days later they look at the dashboard and think,\
“this data doesn’t really help me.”

In most cases, it’s not the data, it’s the setup.

So take a few minutes here. It makes a big difference.

***

## Your Project Structure

<Card title="Foundation" icon="layer-group">
  Inside MentionPilot, your entire project is built around two things:

  the prompts you track

  the competitors you compare against
</Card>

Once those are in place, everything else (visibility, position, sentiment, trends) starts building automatically across platforms like AI Overviews, ChatGPT, Gemini, and Perplexity AI.

***

## Start with prompts (this is the foundation)

<Card title="Prompts" icon="message">
  Before anything else, you need to tell MentionPilot what conversations you care about.
</Card>

That’s what prompts are.

Not keywords. Not search terms. Actual questions people ask AI.

***

### A simple way to think about it

Open ChatGPT for a second and ask yourself:

“What would my customer type here before choosing a product like mine?”

That’s your prompt.

***

### Example

<Columns>
  <Card title="Agency">
    “Which SEO agency should I hire for an eCommerce brand?”\
    “Best digital marketing agency for SaaS companies”
  </Card>

  <Card title="SaaS">
    “What’s the best CRM for small teams?”\
    “What tools help improve lead generation?”
  </Card>
</Columns>

***

### Why this matters more than it seems

AI doesn’t match keywords the way Google does.

It tries to understand:

* what the user wants
* what situation they’re in

So, a vague prompt gives vague results.

A specific prompt gives you much more useful data.

***

## What happens after you add a prompt

<Card title="Behind the scenes" icon="gear">
  Once you add a prompt in MentionPilot, a few things start happening in the background.
</Card>

We begin running that prompt across different AI platforms.

Then for each response, we track:

* whether your brand was mentioned (Visibility)
* where it appeared in the answer (Position)
* how it was described (Sentiment)
* when it was added (so you can track changes over time)

***

## Let’s break that down simply

<Card title="Metrics Overview" icon="chart-line">
  You don’t need to overthink the metrics, but you should understand what they mean when you see them.
</Card>

### Visibility

This is the easiest one.

Out of all the responses we collected for that prompt, how many included your brand?

If you’re showing up in 2 out of 10 responses, your visibility is low.

If you’re in 7 or 8, you’re doing well.

***

### Position

This is about placement.

If AI lists 5 tools and your brand is mentioned first, that’s strong.

If you’re mentioned last, the impact is much lower.

Over time, we show you the average position so you can see if you’re moving up or down.

***

### Sentiment

This is about how AI talks about you.

Are you being recommended positively?\
Just mentioned? Or described in a negative way?

This becomes important very quickly because users often trust the tone of AI responses.

***

## Each prompt has its own timeline

<Card title="Timeline" icon="clock">
  One thing a lot of users miss: Every prompt has its own history.
</Card>

You can go back and see:

* how your visibility changed
* when you started appearing more (or less)
* whether something you did had an impact

This is useful when you’re testing content, PR, or SEO changes.

***

<Card title="Next Step → Manage Your Setup" icon="arrow-right" href="/manage-setup">
  Continue to learn how to manage prompts and competitors effectively.
</Card>


# User Profile
Source: https://help.mentionpilot.ai/project/user_profile

Manage your account details, limits, and tracking setup

***

You can access this from: Settings → User Profile

***

## What you’ll find here

***

### Email & account details

This is your basic account information.

* Your registered email
* Login-related details

If you ever need to update your email or manage account access, this is where you do it.

***

### Prompt limit (very important)

<Card title="Important" icon="triangle-exclamation">
  Every plan in MentionPilot comes with a limit on how many prompts you can actively track.
</Card>

Here you’ll see:

* Total prompt limit (based on your plan)
* Number of active prompts currently running

***

### How this affects you

As you scale your tracking, you’ll need to decide:

* Which prompts are worth keeping active
* Which ones should be paused

You don’t need to delete anything — you can simply deactivate prompts and free up space.

***

### Country / location setting

This controls where your prompts are executed from.

***

### Why this matters

AI platforms can return different answers depending on location.

For example:

* A query run in the UK may prioritize UK-based brands
* The same query in India may return different results

***

### Simple recommendation

<Card title="Recommendation" icon="lightbulb">
  Set your country based on:

  Your target market (not your personal location)
</Card>

***

<Card title="Next → Brand Profile" icon="arrow-right" href="brand_profile">
  Control which brands you track and compare.
</Card>


# Quickstart Guide
Source: https://help.mentionpilot.ai/quickstart

Get your first AI visibility insights in under 10 minutes

This guide helps you get up and running quickly inside MentionPilot.

You don’t need to overthink anything here.

Set this up once, let it run for a day or two, and you’ll start seeing how your brand shows up across:

* AI Overviews
* ChatGPT
* Gemini
* Perplexity AI

You’ll have your first usable insights in 24–48 hours.

***

## Before you start (quick mindset shift)

<Card title="Important" icon="triangle-exclamation">
  This is not like setting up an SEO tool.

  You’re not adding keywords.

  You’re telling MentionPilot:

  “These are the conversations or prompts where you want your brand to show up.”

  That’s it.
</Card>

***

## Step 1: Add your prompts

<AccordionGroup>
  <Accordion icon="message" title="Prompts are just questions people ask AI tools">
    Prompts are just questions people ask AI tools.

    That’s what we track.
  </Accordion>

  <Accordion icon="list" title="What you need to do">
    Add your first few prompts
  </Accordion>

  <Accordion icon="lightbulb" title="How to think about prompts">
    Don’t try to be clever here. Ask clear questions:

    “What would my ideal customer type into ChatGPT before choosing a product like mine?”
  </Accordion>

  <Accordion icon="file-lines" title="Examples">
    If you’re an agency few prompts examples for you:

    “Which SEO agency should I hire for an ecommerce brand?”\
    “Best digital marketing agency for SaaS companies”

    If you’re a SaaS few prompts' examples for you:

    “What’s the best CRM for small teams?”\
    “Alternatives to HubSpot for startups”
  </Accordion>

  <Accordion icon="bolt" title="Easy shortcut">
    If you already have SEO data:

    Open your Google Search Console

    Take your top keywords

    Rewrite them like a human question
  </Accordion>

  <Accordion icon="circle-info" title="One important thing to note">
    Your prompts won’t be perfect.

    They’re not supposed to be.

    You’ll tweak them later once you see data.
  </Accordion>
</AccordionGroup>

***

## Step 2: Add competitors

<AccordionGroup>
  <Accordion icon="users" title="What you need to do">
    Add your top competitors
  </Accordion>

  <Accordion icon="sliders" title="How to do it">
    Go to the sidebar section and:

    You can check suggested competitors (we detect them automatically)

    Or you can add them manually
  </Accordion>

  <Accordion icon="chart-line" title="Why these matters">
    You’ll start seeing:

    Who AI recommends instead of you

    Who shows up more often

    Who gets better placement
  </Accordion>

  <Accordion icon="lightbulb" title="Small but important tip">
    Use clean brand names.

    “HubSpot” → correct

    “hubspot.com” → not correct

    We track how AI mentions brands, not URLs.
  </Accordion>
</AccordionGroup>

***

## Step 3: Check your dashboard

After setup, give it some time.

Usually within 24–48 hours, you’ll start seeing data.

<AccordionGroup>
  <Accordion icon="grid" title="What you need to do">
    Go to your Overview dashboard
  </Accordion>

  <Accordion icon="chart-bar" title="What to look at first">
    Don’t try to analyse everything.

    Focus on these 3 things:

    1. Visibility

    How often are you showing up?

    That’s your baseline.

    2. Competitors

    Who is appearing more than you?

    That’s your gap.

    3. Recent Chats

    This is the most important part.

    Read what AI is saying.
  </Accordion>

  <Accordion icon="filter" title="Filters (use these later)">
    You can filter by:

    Platform (ChatGPT, Gemini, etc.)

    Date

    Competitors

    Don’t overuse filters on day one. Keep it simple.
  </Accordion>
</AccordionGroup>

***

## Step 4: Look at sources (this is where the real insight is)

<Card title="Important" icon="triangle-exclamation">
  Most people skip this.

  They shouldn’t.
</Card>

<AccordionGroup>
  <Accordion icon="database" title="What you need to do">
    Go to the Sources section
  </Accordion>

  <Accordion icon="circle-info" title="What this shows">
    When AI gives answers, it relies on content from the web.

    We show you those sources.
  </Accordion>

  <Accordion icon="search" title="What to look for">
    1. Sites where competitors appear

    → That’s a signal\
    You probably need to be there too

    2. Industry sites you’re missing from

    → Outreach opportunity\
    PR, guest posts, mentions

    3. Your own content showing up

    → Double down\
    That’s already working
  </Accordion>

  <Accordion icon="clock" title="Important">
    Don’t jump into deep analysis on day one.

    Let data build for a few days.

    Patterns become clearer over time.
  </Accordion>
</AccordionGroup>

***

## What happens next?

<Card title="Automation" icon="gear">
  MentionPilot keeps tracking automatically.

  You don’t need to do anything daily.
</Card>

Within a few days, you’ll start seeing:

* Where you’re visible
* Where you’re missing
* Which competitors dominate
* Which sources influence results

***

## What you should do after this

<CardGroup>
  <Card title="Improve your prompts">
    Add more scenarios, more intent types
  </Card>

  <Card title="Study your sources">
    This is where most growth opportunities come from
  </Card>

  <Card title="Start taking action">
    Content, PR, mentions based on actual data
  </Card>
</CardGroup>

***

## One last thing (this matters)

<Card title="Mindset Shift" icon="repeat">
  If you treat this like an SEO tool, you’ll miss the point.
</Card>

Old way

“What keywords do I rank for?”

New way

“Is my brand showing up when AI recommends something in my category?”

That’s the shift.

***

## You’re done

<Card title="Setup Complete" icon="check-circle">
  Your setup is complete.

  Now let the system run and come back once you have data.
</Card>