# Mavel

> Mavel tracks your brand's visibility across ChatGPT, Perplexity, Gemini, Claude, and other AI search surfaces.

## Docs

- [API keys](https://docs.mavel.ai/account/api-keys.md): Provision and manage the keys that authenticate REST API requests, and understand the plan and rate-limit rules that apply.
- [Members](https://docs.mavel.ai/account/members.md): Invite teammates to your organization, understand the three roles, and remove access when needed.
- [Plans and billing](https://docs.mavel.ai/account/plans.md): The three plan axes, what each tier unlocks, and how plan changes take effect.
- [Actions](https://docs.mavel.ai/actions/overview.md): Prioritized recommendations (content to create, off-page targets to pursue, and technical fixes to apply), each backed by evidence from your tracked answers.
- [Create brand](https://docs.mavel.ai/api-reference/brands/create-brand.md)
- [Get brand](https://docs.mavel.ai/api-reference/brands/get-brand.md)
- [List brands](https://docs.mavel.ai/api-reference/brands/list-brands.md)
- [Soft-delete brand](https://docs.mavel.ai/api-reference/brands/soft-delete-brand.md)
- [Update brand](https://docs.mavel.ai/api-reference/brands/update-brand.md)
- [List model channels](https://docs.mavel.ai/api-reference/catalog/list-model-channels.md)
- [List models](https://docs.mavel.ai/api-reference/catalog/list-models.md)
- [Get a chat](https://docs.mavel.ai/api-reference/chats/get-a-chat.md)
- [List recent chats](https://docs.mavel.ai/api-reference/chats/list-recent-chats.md)
- [Bulk-ingest crawl events from the customer's CF Worker](https://docs.mavel.ai/api-reference/crawl/bulk-ingest-crawl-events-from-the-customers-cf-worker.md)
- [API Introduction](https://docs.mavel.ai/api-reference/introduction.md): The Mavel REST API: authentication, rate limits, pagination, and errors.
- [Get the project profile](https://docs.mavel.ai/api-reference/profile/get-the-project-profile.md)
- [Replace the project profile](https://docs.mavel.ai/api-reference/profile/replace-the-project-profile.md)
- [List projects in the org](https://docs.mavel.ai/api-reference/projects/list-projects-in-the-org.md)
- [Create prompt](https://docs.mavel.ai/api-reference/prompts/create-prompt.md)
- [Get prompt](https://docs.mavel.ai/api-reference/prompts/get-prompt.md)
- [List prompts](https://docs.mavel.ai/api-reference/prompts/list-prompts.md)
- [Soft-delete prompt](https://docs.mavel.ai/api-reference/prompts/soft-delete-prompt.md)
- [Update prompt](https://docs.mavel.ai/api-reference/prompts/update-prompt.md)
- [Actions report](https://docs.mavel.ai/api-reference/reports/actions-report.md)
- [Crawl-events report](https://docs.mavel.ai/api-reference/reports/crawl-events-report.md)
- [Run a brand-metrics report (dimensions, filters, ordering)](https://docs.mavel.ai/api-reference/reports/run-a-brand-metrics-report-dimensions-filters-ordering.md)
- [Tag-metrics report](https://docs.mavel.ai/api-reference/reports/tag-metrics-report.md)
- [Fetch the cached Markdown for a URL](https://docs.mavel.ai/api-reference/sources/fetch-the-cached-markdown-for-a-url.md)
- [List source domains](https://docs.mavel.ai/api-reference/sources/list-source-domains.md)
- [List source URLs](https://docs.mavel.ai/api-reference/sources/list-source-urls.md)
- [Accept a brand suggestion](https://docs.mavel.ai/api-reference/suggestions/accept-a-brand-suggestion.md)
- [Accept a prompt suggestion](https://docs.mavel.ai/api-reference/suggestions/accept-a-prompt-suggestion.md)
- [Accept a topic suggestion](https://docs.mavel.ai/api-reference/suggestions/accept-a-topic-suggestion.md)
- [List pending brands suggestions](https://docs.mavel.ai/api-reference/suggestions/list-pending-brands-suggestions.md)
- [List pending prompts suggestions](https://docs.mavel.ai/api-reference/suggestions/list-pending-prompts-suggestions.md)
- [List pending topics suggestions](https://docs.mavel.ai/api-reference/suggestions/list-pending-topics-suggestions.md)
- [Reject a brand suggestion](https://docs.mavel.ai/api-reference/suggestions/reject-a-brand-suggestion.md)
- [Reject a prompt suggestion](https://docs.mavel.ai/api-reference/suggestions/reject-a-prompt-suggestion.md)
- [Reject a topic suggestion](https://docs.mavel.ai/api-reference/suggestions/reject-a-topic-suggestion.md)
- [Create tag](https://docs.mavel.ai/api-reference/tags/create-tag.md)
- [Get tag](https://docs.mavel.ai/api-reference/tags/get-tag.md)
- [List tags](https://docs.mavel.ai/api-reference/tags/list-tags.md)
- [Soft-delete tag](https://docs.mavel.ai/api-reference/tags/soft-delete-tag.md)
- [Update tag](https://docs.mavel.ai/api-reference/tags/update-tag.md)
- [Create topic](https://docs.mavel.ai/api-reference/topics/create-topic.md)
- [Get topic](https://docs.mavel.ai/api-reference/topics/get-topic.md)
- [List topics](https://docs.mavel.ai/api-reference/topics/list-topics.md)
- [Soft-delete topic](https://docs.mavel.ai/api-reference/topics/soft-delete-topic.md)
- [Update topic](https://docs.mavel.ai/api-reference/topics/update-topic.md)
- [Developers: API + MCP](https://docs.mavel.ai/developers.md): Two ways to build on Mavel: the REST API and the MCP server.
- [Looker Studio connector](https://docs.mavel.ai/integrations/looker.md): Connect Mavel brand visibility data to Looker Studio (formerly Data Studio) for client-facing dashboards and custom reports.
- [Welcome to Mavel](https://docs.mavel.ai/intro-to-mavel.md): Mavel tracks how visible your brand is in AI answers, across ChatGPT, Perplexity, Gemini, Claude, Google AI Overviews, and more.
- [Authentication](https://docs.mavel.ai/mcp/authentication.md): OAuth 2.0 with PKCE and dynamic client registration: how MCP clients authenticate, and the full protocol surface.
- [Claude Code plugin](https://docs.mavel.ai/mcp/claude-code-plugin.md): Install the official Mavel plugin for Claude Code: MCP tools, report skills, and in-terminal onboarding.
- [MCP Server](https://docs.mavel.ai/mcp/introduction.md): Query your Mavel data from Claude, Cursor, VS Code, and any MCP-compatible client.
- [Prompts](https://docs.mavel.ai/mcp/prompts.md): Seven built-in slash commands that package common analyses. Each takes project_id as its first argument.
- [Setup](https://docs.mavel.ai/mcp/setup.md): Connect the Mavel MCP server to Claude Desktop, Cursor, VS Code, or Windsurf.
- [Tools](https://docs.mavel.ai/mcp/tools.md): The 41 MCP tools: 20 read tools and 21 write tools, grouped by area.
- [Quickstart](https://docs.mavel.ai/quickstart.md): From signup to your first tracked AI answers in about ten minutes.
- [Chats](https://docs.mavel.ai/results/chats.md): The raw captured answers behind every metric: full text, brand detections, and cited sources.
- [Crawlability](https://docs.mavel.ai/results/crawlability.md): Whether AI crawlers can actually read your site: robots.txt analysis and measured bot visit tracking.
- [Metrics overview](https://docs.mavel.ai/results/metrics-overview.md): How Mavel's four core brand metrics (Visibility, Position, Sentiment, and Share of Voice) are computed from every day's captured answers, and how to read them together.
- [Position](https://docs.mavel.ai/results/position.md): Where in the answer your brand appears when it appears: the average rank across all mentions in the selected window.
- [Sentiment](https://docs.mavel.ai/results/sentiment.md): A 0-100 index of how AI answers characterize your brand when they mention it, built from LLM scoring of each mention span.
- [Share of Voice](https://docs.mavel.ai/results/share-of-voice.md): Your brand's share of all tracked-brand mentions in your category's AI answers: the competitive measure of how much of the conversation is yours.
- [Sources](https://docs.mavel.ai/results/sources.md): The domains and URLs AI engines cite when answering your prompts: where your content strategy starts.
- [Visibility](https://docs.mavel.ai/results/visibility.md): The share of captured answers in which your brand appears: computed per prompt, per surface, and rolled up across your selected date range.
- [Brands and competitors](https://docs.mavel.ai/setup/brands.md): How Mavel detects your brand and competitors in every AI answer, and how to keep detection accurate.
- [Project profile](https://docs.mavel.ai/setup/project-profile.md): What Mavel knows about your company: how it is created, what fields it holds, and where it drives results downstream.
- [Setting up your prompts](https://docs.mavel.ai/setup/prompts.md): Prompts are the buyer questions Mavel runs against AI surfaces every day. Here's how to build a set that produces useful measurements.
- [Surfaces](https://docs.mavel.ai/setup/surfaces.md): The eight AI engines Mavel tracks, how to enable them per project, and why per-country collection matters.
- [Topics and tags](https://docs.mavel.ai/setup/topics-and-tags.md): Topics group prompts by theme so metrics slice cleanly. Tags add cross-cutting labels for funnel stage, campaign, or intent.

## OpenAPI Specs

- [openapi](https://app.mavel.ai/api/v1/openapi.json)