# @mager/loooom-mcp

An MCP (Model Context Protocol) server for [Loooom](https://loooom.xyz) — the Claude Code plugin/skill marketplace. Lets AI agents discover, search, and explore skills from the Loooom marketplace.

## What is Loooom?

Loooom is a marketplace for Claude Code plugins and skills. This MCP server gives AI agents direct access to browse and find skills they can install.

## Usage

### npx (no install required)

```bash
npx @mager/loooom-mcp
```

### Global install

```bash
npm install -g @mager/loooom-mcp
loooom-mcp
```

## Claude Desktop Configuration

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "loooom": {
      "command": "npx",
      "args": ["-y", "@mager/loooom-mcp"]
    }
  }
}
```

Config file locations:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

## Available Tools

| Tool | Description |
|------|-------------|
| `list_skills` | List all skills (name, description, category, version, author, homepage) |
| `search_skills` | Filter skills by query string and optional category |
| `get_skill` | Get full details for a single skill by name |
| `list_categories` | List all unique categories with skill counts |
| `get_install_command` | Get the Claude Code install command for a skill |

### Tool Examples

**List all skills:**
```
Use the list_skills tool to show me what's available on Loooom.
```

**Search for language skills:**
```
Use search_skills with query="japanese" to find language learning skills.
```

**Install a skill:**
```
Use get_install_command for "beginner-japanese" to get the install command.
```
Returns: `/plugin marketplace add mager/loooom beginner-japanese`

## Data Source

The skill catalog is fetched at runtime from:
```
https://raw.githubusercontent.com/mager/loooom/main/.claude-plugin/marketplace.json
```

The catalog is cached in memory and refreshed every 5 minutes. Failures fall back to cached data gracefully.

## Development

```bash
git clone https://github.com/mager/loooom-mcp
cd loooom-mcp
npm install
npm run build
npm start
```

## License

MIT