Plugin Usage - AgentPowers

Installation

Add the AgentPowers MCP server to your Claude Code config:

claude mcp add agentpowers -- npx -y @agentpowers/mcp-server

Or add it manually to your .mcp.json:

{
  "mcpServers": {
    "agentpowers": {
      "command": "npx",
      "args": ["@agentpowers/mcp-server"]
    }
  }
}

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

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.

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:

ap login

The plugin picks up the token automatically.

Guided Flow (`/ap`)

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

Search — Find skills by keyword
Browse categories — Explore available categories
Check updates — See if your installed skills have newer versions
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:

claude mcp list

Authentication errors

Re-authenticate via the CLI:

ap logout
ap login

Skill not installing

Check that the target directory exists and is writable:

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?

Email Support

Reach us at [email protected] for account issues, billing questions, or technical help.

Discord Community

Join the AgentPowers Discord to get help from the team and other creators in real time.

Documentation Index

​Installation

​Authentication

​Guided Flow (/ap)

​Available Tools

​search_marketplace

​get_skill_details

​install_skill

​check_purchase_status

​check_installed

​uninstall_skill

​check_for_updates

​Platforms

​Troubleshooting

​MCP server not loading

​Authentication errors

​Skill not installing

​Choosing Your Install Method

​Need Help?