# skillsindex-mcp

MCP server for [SkillsIndex](https://skillsindex.dev) — the scored directory of 11,000+ AI agent tools (MCP servers, Claude skills, GPT actions, IDE plugins).

Give your AI agents the ability to **search**, **score**, **review**, and **submit** tools from the largest independent AI tool directory.

## Tools

| Tool | Description |
|------|-------------|
| `search_tools` | Search by keyword, ecosystem, or category — returns ranked results with scores |
| `get_tool` | Full details for a tool: security score, GitHub stats, scoring breakdown |
| `get_top_rated` | Top-rated tools, optionally filtered by ecosystem or category |
| `check_security` | Security score (0-5) + audit notes for any indexed tool |
| `submit_tool` | Submit a new tool for indexing — auto-adds to the review queue |
| `subscribe` | Subscribe an email to The Weekly Index (Thursday newsletter) |

## Install

```bash
npx skillsindex-mcp
```

Or install globally:

```bash
npm install -g skillsindex-mcp
```

## Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "skillsindex": {
      "command": "npx",
      "args": ["skillsindex-mcp"]
    }
  }
}
```

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

## Cursor / Windsurf / Cline

Add to your MCP settings:

```json
{
  "skillsindex": {
    "command": "npx",
    "args": ["skillsindex-mcp"]
  }
}
```

## Usage Examples

Once connected, you can ask Claude things like:

- *"Search for MCP servers that connect to databases"*
- *"What's the security score for the filesystem-mcp-server?"*
- *"Show me the top 10 Claude skills"*
- *"Submit this GitHub repo to SkillsIndex: https://github.com/..."*
- *"Subscribe me to the SkillsIndex weekly newsletter"*

## Tool Details

### `search_tools`

```
query:      Search keyword or use case (required)
ecosystem:  mcp_server | claude_skill | gpt_action | openclaw_skill | plugin
category:   databases-storage | browser-automation | code-execution | ...
limit:      1-20 (default: 5)
```

### `get_tool`

```
slug:  Tool slug, e.g. "filesystem-mcp-server" (from the URL: skillsindex.dev/tools/[slug]/)
```

### `get_top_rated`

```
ecosystem:  optional filter
category:   optional filter
limit:      1-20 (default: 10)
```

### `check_security`

```
slug:  Tool slug (preferred)
name:  Tool name (fuzzy match fallback)
```

### `submit_tool`

```
name:        Tool name (required)
github_url:  GitHub repo or homepage URL (required)
description: What the tool does (required, min 10 chars)
ecosystem:   mcp_server | claude_skill | gpt_action | ... (default: mcp_server)
category:    databases-storage | browser-automation | ... (default: other)
```

Submissions land in a review queue. Tools are scored on security, utility, maintenance, and uniqueness before publishing.

### `subscribe`

```
email:  Email address to subscribe (required)
```

## Data

- **11,393+ tools** across 5 ecosystems
- Scoring: security (30%) + utility (30%) + maintenance (25%) + uniqueness (15%)
- Updated weekly via GitHub API
- Security scores based on static analysis of source code

## Links

- Directory: [skillsindex.dev](https://skillsindex.dev)
- Browse: [skillsindex.dev/browse/](https://skillsindex.dev/browse/)
- Submit a tool: [skillsindex.dev/submit/](https://skillsindex.dev/submit/)
- Scoring methodology: [skillsindex.dev/methodology/](https://skillsindex.dev/methodology/)
- Newsletter: The Weekly Index — every Thursday

## License

MIT