Skip to main content
Glama
Superpowers MCP Server

Superpowers MCP Server

by jmcdice

Superpowers MCP Server for Augment

An MCP (Model Context Protocol) server that brings the powerful Superpowers skills library to Augment CLI. Access proven workflows, expert techniques, and best practices directly in your AI coding assistant.

What is This?

This MCP server exposes the Superpowers skills library as tools that Augment can use. Skills are expert-crafted workflows and processes that guide AI assistants to produce better results.

Available Tools:

  • find_skills - List all available skills from both the superpowers library and your personal skills

  • use_skill - Load a specific skill to guide your work

Related MCP server: Agent Skills MCP

Prerequisites

Quick Start

1. Clone and Install

git clone https://github.com/jmcdice/superpower-mcp.git
cd superpower-mcp
./install.sh

The installer will:

  • Clone the upstream Superpowers repository to ~/.augment/superpowers

  • Create a personal skills directory at ~/.augment/skills

  • Install MCP server dependencies

  • Provide configuration instructions

2. Configure Augment

Add the MCP server to your Augment configuration file (~/.augment/settings.json):

{
  "mcpServers": {
    "superpowers": {
      "command": "node",
      "args": [
        "/path/to/superpower-mcp/superpowers-mcp.js"
      ]
    }
  }
}

Note: Replace /path/to/superpower-mcp/ with the actual path where you cloned this repository. The installer will show you the exact path to use.

3. Restart Augment

Restart Augment to load the new MCP server.

4. Test It

Ask Augment:

"What skills are available?"

You should see a list of skills from the Superpowers library.

Usage

Finding Skills

Ask Augment to list available skills:

"Show me available skills"
"What skills can you use?"

Or use the tool directly:

find_skills()

Using Skills

Load a skill by name:

"Use the brainstorming skill"
"Load the test-driven-development skill"

Or use the tool directly:

use_skill("superpowers:brainstorming")
use_skill("superpowers:test-driven-development")

Skill Naming Convention

  • Superpowers skills: superpowers:skill-name (from the upstream repository)

  • Personal skills: my-skill-name (from ~/.augment/skills/)

Personal skills with the same name as superpowers skills will override them.

Creating Personal Skills

  1. Create a directory in ~/.augment/skills/ with your skill name:

    mkdir -p ~/.augment/skills/my-custom-skill
  2. Add a SKILL.md file with YAML frontmatter:

    ---
    name: my-custom-skill
    description: Use when you need to do something specific
    ---
    
    # My Custom Skill
    
    ## Purpose
    [Describe what this skill does]
    
    ## When to Use
    [Describe when to use this skill]
    
    ## Process
    1. [Step 1]
    2. [Step 2]
    3. [Step 3]
  3. The skill will automatically be available through find_skills and use_skill

Architecture

This is an overlay approach that works with the upstream Superpowers repository:

  • Upstream repository: ~/.augment/superpowers (read-only, updated via git pull)

  • MCP server: This repository (custom Augment integration)

  • Personal skills: ~/.augment/skills (your custom skills)

The MCP server reads skills from both the upstream repository and your personal skills directory.

Management

Update Superpowers

To get the latest skills from the upstream repository:

./install.sh update

Then restart Augment.

Uninstall

./install.sh remove

This will:

  • Remove the Superpowers repository (~/.augment/superpowers)

  • Optionally remove your personal skills (~/.augment/skills)

  • Keep the MCP server files (you can delete them manually if desired)

Don't forget to remove the MCP server configuration from ~/.augment/settings.json and restart Augment.

Troubleshooting

MCP Server Not Showing Up

  1. Check that the path in ~/.augment/settings.json is correct

  2. Verify Node.js is installed: node --version (should be v18+)

  3. Check that dependencies are installed: ls node_modules in the repo directory

  4. Restart Augment completely

Skills Not Loading

  1. Verify the Superpowers repository exists: ls ~/.augment/superpowers/skills

  2. Run ./install.sh update to refresh the repository

  3. Check skill file format (must have YAML frontmatter and be named SKILL.md)

Permission Errors

Make sure the install script is executable:

chmod +x install.sh

Contributing

Issues and pull requests are welcome! This is a community project to make Superpowers accessible to Augment users.

License

MIT License - See LICENSE file for details

The upstream Superpowers repository has its own license. Please refer to https://github.com/obra/superpowers for details.

Credits

Available Tools

2 tools
find_skillsB

List all available skills in the personal and superpowers skill libraries.

Inputs: no named parameters.

use_skillB

Load and read a specific skill to guide your work. Skills contain proven workflows, mandatory processes, and expert techniques.

Inputs: skill_name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: 'find_skills' is for listing available skills, while 'use_skill' is for loading and reading a specific skill. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern with snake_case naming: 'find_skills' and 'use_skill'. The naming is uniform and predictable throughout the set.

    Tool Count2/5

    With only 2 tools, the server feels thin for a 'Superpowers MCP Server' that implies managing skills and workflows. This minimal set may not adequately cover the domain's potential scope, such as creating, updating, or deleting skills.

    Completeness2/5

    The tool set is severely incomplete for skill management. It only supports listing and reading skills, lacking essential CRUD operations like creating, updating, or deleting skills, which are likely needed for a comprehensive skill library system.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Search, install, and manage AI agent skills (SKILL.md files) from GitHub repositories. Features workspace analysis for personalized recommendations and supports 140+ pre-indexed skills.
      9
      38 npm
      12
      Creative Commons Attribution Non Commercial Share Alike 4.0 International
    • A
      license
      A
      quality
      D
      maintenance
      Enables discovery and installation of agent skills from curated GitHub repositories, allowing users to search large collections and inspect skill contents directly. It supports downloading skills locally and provides grounded scaffolds for creating new skills based on existing patterns.
      5
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables LLM agents to discover and search a catalog of skills, then fetch skill instructions and supporting references, scripts, and assets on demand.
      10
      MIT