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

# Quickstart

> Get started with AgentPowers in under 5 minutes

## Install

<Tabs>
  <Tab title="MCP Server (Recommended)">
    Add to your `.mcp.json` (no global install needed):

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

    Or add via the CLI:

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

    See [MCP Server guide](/guides/mcp-server) for full setup.
  </Tab>

  <Tab title="Skill (Zero Dependencies)">
    Clone the standalone skill directly. No Node.js or Python required:

    ```bash theme={null}
    git clone https://github.com/AgentPowers-AI/agentpowers-skill ~/.claude/skills/agentpowers
    ```

    Then use `/agentpowers` in any Claude Code conversation. See [Skill guide](/guides/skill-usage) for details.
  </Tab>

  <Tab title="CLI">
    Run directly with npx (no global install needed):

    ```bash theme={null}
    npx @agentpowers/cli setup
    ```

    Auto-configures MCP for all detected AI tools. Requires Node.js 18+.

    <Tip>
      `pip install agentpowers` is still supported but npx is preferred.
    </Tip>
  </Tab>
</Tabs>

## Search for Skills

```bash theme={null}
npx @agentpowers/cli search "code review"
```

This returns a table of matching skills with titles, prices, security status, and download counts.

## Install a Free Skill

```bash theme={null}
npx @agentpowers/cli install my-awesome-skill
```

The CLI downloads and extracts the skill to `~/.claude/skills/my-awesome-skill/`.

## Install a Paid Skill

```bash theme={null}
npx @agentpowers/cli install premium-agent
```

For paid skills, the CLI opens a Stripe Checkout page. After purchase, you receive a license code. The skill installs automatically after payment, or you can redeem the license code later:

```bash theme={null}
npx @agentpowers/cli install premium-agent --code XXXXXXXX-XXXXXXXX-XXXXXXXX
```

## Use In-Conversation (MCP Server)

The MCP server gives Claude access to marketplace tools during your conversation. Add it to your Claude Code settings or `.mcp.json`:

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

See [MCP Server guide](/guides/mcp-server) for full setup details.

## Publish a Skill

<Tabs>
  <Tab title="Website (Recommended)">
    <Steps>
      <Step title="Create your skill file">
        Write a `.skill` or `.md` file with YAML frontmatter:

        ```yaml theme={null}
        ---
        title: My Awesome Skill
        description: A skill that does amazing things
        category: development
        ---

        Instructions for Claude when using this skill...
        ```
      </Step>

      <Step title="Go to the Publish page">
        Navigate to [agentpowers.ai/dashboard/publish](https://agentpowers.ai/dashboard/publish) and sign in.
      </Step>

      <Step title="Upload and publish">
        Drop your `.skill`, `.md`, or `.zip` file. The form auto-fills from your frontmatter. Review the details, set a price (or leave free), and hit Publish.
      </Step>
    </Steps>

    Your skill enters the security review pipeline. Once approved, it appears in the marketplace.
  </Tab>

  <Tab title="CLI">
    <Steps>
      <Step title="Create your skill directory">
        ```
        my-skill/
        ├── SKILL.md      # Frontmatter with title, description
        └── ...            # Your skill files
        ```
      </Step>

      <Step title="Login and publish">
        ```bash theme={null}
        npx @agentpowers/cli login
        npx @agentpowers/cli publish --dir ./my-skill --price 5.00
        ```
      </Step>
    </Steps>

    Your skill enters the security review pipeline. Once approved, it appears in the marketplace.
  </Tab>
</Tabs>

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