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

# Remote MCP Server

> Use AgentPowers directly in claude.ai via the remote MCP server

## Overview

The AgentPowers remote MCP server lets you browse, search, and interact with
the marketplace directly from [claude.ai](https://claude.ai). No CLI installation
required -- just add the server URL to your claude.ai settings and start
discovering skills in conversation.

With OAuth authentication enabled, you can also view your account profile and
purchase history directly in claude.ai.

## Setup

### Add to claude.ai

1. Open [claude.ai](https://claude.ai) and go to **Settings**
2. Navigate to **Integrations** (or **MCP Servers**)
3. Click **Add Custom Integration**
4. Enter the server URL:

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

5. Save and start a new conversation

### Authenticate (optional)

To use authenticated tools (profile, purchase history), click **Configure** on
the AgentPowers integration. This opens the AgentPowers login page where you can
sign in with your existing account. Once authenticated, claude.ai will include
your credentials in all requests automatically.

### Verify it works

In a new conversation, try:

> "Search AgentPowers for productivity skills"

Claude should use the `search_marketplace` tool and return results from the
marketplace.

## Available tools

The remote MCP server exposes 9 tools:

### Public tools (no authentication required)

| Tool                 | Description                                                                      |
| -------------------- | -------------------------------------------------------------------------------- |
| `search_marketplace` | Search by keyword, category, or type with configurable limits                    |
| `get_skill_details`  | Full details for a skill or agent by slug, including pricing and security status |
| `get_categories`     | List all skill categories with live skill counts                                 |
| `get_seller_profile` | View a seller's profile, bio, and published skills                               |
| `get_skill_reviews`  | Read reviews and ratings for a skill                                             |
| `get_platforms`      | List supported AI platforms for skill installation                               |

### Authenticated tools (requires OAuth)

| Tool                  | Description                                   |
| --------------------- | --------------------------------------------- |
| `start_checkout`      | Start purchasing a paid skill                 |
| `get_account_profile` | View your AgentPowers account profile         |
| `list_purchases`      | List your purchased skills with license codes |

<Note>
  If you call an authenticated tool without being signed in, you'll get a
  helpful message asking you to configure the integration first.
</Note>

### Example prompts

* "What categories of skills are available on AgentPowers?"
* "Show me the details for the code-review skill"
* "Find security-related skills"
* "Who is the seller behind this skill?"
* "Show me my AgentPowers purchases"
* "What's my AgentPowers profile?"

## Authentication

The remote server uses OAuth 2.0 with PKCE (Proof Key for Code Exchange) for
secure authentication. When you click **Configure** on the integration:

1. claude.ai discovers the OAuth endpoints via `/.well-known/oauth-authorization-server`
2. It registers as an OAuth client (one-time, automatic)
3. You're redirected to the AgentPowers login page
4. After signing in, an authorization code is exchanged for access tokens
5. Tokens are refreshed automatically -- you stay signed in

Your access tokens expire after 1 hour and are automatically refreshed.

## Limitations

The following features require the [CLI](/guides/cli-usage) or
[Claude Desktop extension](/guides/claude-extension):

* **Installation** -- downloading and installing skills to your local machine
* **Publishing** -- uploading and managing your own skills

## Technical details

* **Protocol:** MCP over Streamable HTTP (primary) + SSE (legacy)
* **Primary endpoint:** `https://api.agentpowers.ai/mcp`
* **Legacy SSE endpoint:** `https://api.agentpowers.ai/mcp/sse`
* **OAuth discovery:** `https://api.agentpowers.ai/.well-known/oauth-authorization-server`
* **Token endpoint:** `https://api.agentpowers.ai/v1/oauth/token`
* **Agent skills index (RFC v0.2.0):** `https://api.agentpowers.ai/.well-known/agent-skills/index.json` — returns `{"$schema": "...", "skills": [...]}`
* **API catalog:** `https://api.agentpowers.ai/.well-known/api-catalog`
* **OAuth protected resource:** `https://api.agentpowers.ai/.well-known/oauth-protected-resource`
* **MCP server card:** `https://api.agentpowers.ai/.well-known/mcp/server-card.json`

## Source

The remote MCP server is part of the
[AgentPowers API](https://github.com/AgentPowers-AI/agentpowers-app) codebase.

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