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

# Plugin Usage

> Browse and install skills directly inside Claude Code conversations

## Installation

Add the AgentPowers MCP server to your Claude Code config:

```bash theme={null}
claude mcp add agentpowers -- npx -y @agentpowers/mcp-server
```

Or add it manually to your `.mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "agentpowers": {
      "command": "npx",
      "args": ["@agentpowers/mcp-server"]
    }
  }
}
```

<Note>
  The full Claude Code plugin is also available. Install it with:

  ```bash theme={null}
  claude plugin marketplace add AgentPowers-AI/agentpowers-plugin
  claude plugin install agentpowers@agentpowers-plugin
  ```

  The plugin bundles the MCP server below plus session hooks, post-install reminders, and the `/ap` guided flow.
</Note>

The MCP server gives Claude access to marketplace tools during your conversation.

## Authentication

The plugin shares the same auth token stored by the CLI. Log in once with the CLI:

```bash theme={null}
ap login
```

The plugin picks up the token automatically.

## Guided Flow (`/ap`)

Type `/ap` in any conversation to launch the guided marketplace experience:

1. **Search** -- Find skills by keyword
2. **Browse categories** -- Explore available categories
3. **Check updates** -- See if your installed skills have newer versions
4. **Manage installed** -- List and uninstall skills

The `/ap` command uses the same MCP tools listed below but wraps them in a conversational flow.

## Available Tools

Once enabled, Claude has access to these tools during conversation:

### search\_marketplace

Search the marketplace by keyword, category, or type:

```
"Find me a Python testing skill"
"Search for agents in the dev category"
```

Claude calls `search_marketplace` with your query and presents matching results from both AgentPowers and external sources (e.g., ClawHub).

### get\_skill\_details

View details about a specific skill or agent:

```
"Show me details for the code-review-pro skill"
"Get details for weather from ClawHub"
```

Returns the full description, price, security status, version, author, download count, and star rating (average and review count when available). Supports an optional `source` parameter to look up skills from specific sources.

### install\_skill

Install a skill or agent directly from conversation:

```
"Install the code-review-pro skill"
```

Claude will ask **where** to install before proceeding:

* **user** scope — `~/.claude/skills/` (available in every project)
* **project** scope — `./.claude/skills/` (only in this project; commit with the repo to share)

`install_skill` requires the `scope` argument explicitly — there is no default. The `/ap` skill guides Claude to ask the question before invoking the tool. For free skills, installation happens immediately after you pick a scope. For paid skills, Claude opens Stripe Checkout in your browser; the scope question comes after payment completes. The plugin checks security status before installing and saves a version pin for update tracking.

### check\_purchase\_status

Check whether a purchase has completed:

```
"Check the status of my purchase abc-123"
```

Returns payment status and license code if completed. Requires authentication.

### check\_installed

List all installed skills and agents:

```
"What skills do I have installed?"
```

Output is grouped by **scope** so you can see exactly where each skill lives:

* **User** — `~/.claude/skills/` (and `~/.claude/agents/`)
* **Project** — `./.claude/skills/` of the directory Claude Code was launched in (or any ancestor)
* **Plugin (read-only)** — `~/.claude/plugins/<plugin>/skills/`, surfaced so you know what your environment is loading from plugins

Each row shows the skill's version, source (`agentpowers`, `clawhub`, `plugin:<name>`, or `unknown` for unmanaged installs), security status, and whether it has been locally edited.

### uninstall\_skill

Remove an installed skill or agent:

```
"Uninstall the code-review-pro skill"
```

Removes the skill directory and its version pin.

### check\_for\_updates

Check if any installed skills have newer versions available:

```
"Are any of my skills out of date?"
```

Reports which skills are up to date, which have updates, and which have been locally edited. Use `ap update` in your terminal to install updates.

## Platforms

The plugin works across:

| Platform                | Support               |
| ----------------------- | --------------------- |
| Claude Code (CLI)       | Full support          |
| Claude Cowork (desktop) | Full support          |
| claude.ai (web)         | ZIP download fallback |

## Troubleshooting

### MCP server not loading

Verify the MCP server is configured:

```bash theme={null}
claude mcp list
```

### Authentication errors

Re-authenticate via the CLI:

```bash theme={null}
ap logout
ap login
```

### Skill not installing

Check that the target directory exists and is writable:

```bash theme={null}
ls -la ~/.claude/skills/
```

## Choosing Your Install Method

| Feature                   | MCP Server | Skill  | CLI    |
| ------------------------- | ---------- | ------ | ------ |
| Install friction          | Low        | Lowest | Medium |
| Search marketplace        | Yes        | Yes    | Yes    |
| Install skills            | Yes        | Yes    | Yes    |
| Proactive suggestions     | No         | No     | No     |
| Guided `/ap` flow         | No         | No     | No     |
| Session hooks             | No         | No     | No     |
| Works outside Claude Code | Yes        | No     | Yes    |
| Dependencies              | Node.js    | None   | Python |

## Need Help?

<CardGroup cols={2}>
  <Card title="Email Support" icon="envelope" href="mailto:support@agentpowers.ai">
    Reach us at **[support@agentpowers.ai](mailto:support@agentpowers.ai)** for account issues, billing questions, or technical help.
  </Card>

  <Card title="Discord Community" icon="discord" href="https://discord.gg/ECAzvrvHA">
    Join the **AgentPowers Discord** to get help from the team and other creators in real time.
  </Card>
</CardGroup>