> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Query your Mavel data from Claude, Cursor, VS Code, and any MCP-compatible client.

Mavel exposes a [Model Context Protocol](https://modelcontextprotocol.io) server
over Streamable HTTP. Connect it to Claude Desktop, Claude Code, Cursor, VS
Code, or Windsurf and your AI assistant can query (and, with your consent,
modify) your GEO analytics data through a structured tool interface.

**Server URL:**

```
https://mcp.mavel.ai/api/mcp
```

## What you can do

* **41 tools** covering projects, brands, prompts, topics, tags, chats, search
  queries, reports (brand / domain / URL), actions, and the project profile:
  read tools plus explicitly-consented write tools. See [Tools](/mcp/tools).
* **7 built-in prompts** (slash commands) that package common analyses: a
  weekly pulse, a competitor radar, an engine scorecard, and more. See
  [Prompts](/mcp/prompts).

## Connecting

Compliant MCP clients need **no manual configuration** beyond the URL. The
server is an OAuth-protected resource implementing the standard MCP
authorization discovery flow: give your client
`https://mcp.mavel.ai/api/mcp`, and it discovers the authorization server,
self-registers, and walks you through consent in the browser.

Per-client walkthroughs: [Setup](/mcp/setup). Using Claude Code? The
[official plugin](/mcp/claude-code-plugin) configures everything in one
install. Protocol details, scopes, and token lifecycle:
[Authentication](/mcp/authentication).

<Note>
  Authentication is required for every JSON-RPC method, including
  `initialize` and `tools/list`. There is no anonymous tool-catalog preview.
  Requests are rate-limited at 200 per minute per authenticated user.
</Note>