> ## 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.

# Claude Code plugin

> Install the official Mavel plugin for Claude Code: MCP tools, report skills, and in-terminal onboarding.

The [official Mavel plugin](https://github.com/Mavel-AI/claude-plugins) is the
fastest way to connect Claude Code to Mavel. One install configures both Mavel
MCP servers and adds report skills, so you skip the manual server configuration
described in [Setup](/mcp/setup).

## Install

```
/plugin marketplace add mavel-ai/claude-plugins
/plugin install mavel
```

Requires Claude Code 1.0.33 or newer.

## What it bundles

* The **analytics MCP server** (`https://mcp.mavel.ai/api/mcp`): the full
  read and write [tool surface](/mcp/tools) plus the ready-made
  [report prompts](/mcp/prompts). Uses the same browser OAuth consent flow as
  every other client; the plugin ships no credentials or tokens.
* The **onboarding server** (`https://mcp.mavel.ai/api/mcp/onboard`):
  anonymous by design, it only powers the signup wizard.
* **Skills** that Claude invokes for you, or that you run as slash commands:

| Skill                | What it does                                                                                       |
| -------------------- | -------------------------------------------------------------------------------------------------- |
| `/mavel:onboard`     | Creates a Mavel account entirely in the terminal. The only browser steps are checkout and consent. |
| `/mavel:setup`       | Verifies and troubleshoots the connection.                                                         |
| `/mavel:pulse`       | Weekly AI search visibility report for a project.                                                  |
| `/mavel:competitors` | Competitor visibility comparison.                                                                  |

* **Background knowledge**: Claude automatically knows the Mavel data model,
  plan limits, and worked recipes when you ask visibility questions, without
  you invoking anything.

## First run

**New to Mavel?** Run `/mavel:onboard`. The wizard registers your team, sets
up your brand, topics and prompts, and picks a plan, all in the terminal.

**Already a customer?** Run `/mcp`, select the `mavel` server, and complete
the browser consent. Then try `/mavel:pulse`.

<Tip>
  On the consent page you choose whether to grant `mcp:write`. Read-only
  access is enough for reports and analyses; grant write access only if you
  want Claude to create or edit prompts, brands, topics, and tags on your
  behalf. See [Authentication](/mcp/authentication) for the scope model.
</Tip>

Tool calls require a plan with API access (Growth and Enterprise). Any plan
can list the available tools and prompts.

## Managing and revoking access

The plugin appears as a connected agent in the dashboard under
**[Settings → Connected agents](https://app.mavel.ai/connected-agents)**, like
any other MCP client. Revoke it there to disconnect immediately; reconnect any
time by running `/mcp` and approving consent again.

## Troubleshooting

Run `/mavel:setup` and let Claude diagnose the connection. The most common
fixes:

| Symptom                                     | Fix                                                      |
| ------------------------------------------- | -------------------------------------------------------- |
| `mavel` server shows "needs authentication" | Run `/mcp`, select `mavel`, complete the browser consent |
| HTTP 401 on tool calls                      | Same as above; the grant expired or was revoked          |
| Plan or entitlement error                   | Upgrade at [mavel.ai/pricing](https://mavel.ai/pricing)  |
| Servers missing from `/mcp`                 | Reinstall the plugin, then restart the session           |