Content
<div align="center">
<a href="https://codeguilds.dev">
<img src="https://codeguilds.dev/logo/lightlogo9-nobackground.png" alt="CodeGuilds" height="60" />
</a>
<h1>@codeguilds/mcp-server</h1>
<p><a href="https://codeguilds.dev">codeguilds.dev</a> — the community registry for Claude Code</p>
</div>
---
An [MCP server](https://modelcontextprotocol.io) that gives Claude direct access to the [CodeGuilds](https://codeguilds.dev) registry — so you can search, discover, and install Claude Code extensions mid-conversation, without leaving your chat.
## What it does
Once installed, Claude can:
- **Search** the registry for skills, MCP servers, agents, hooks, and prompts
- **Get full details** on any package — description, version, author, links
- **Browse collections** — curated themed sets (React dev setup, security toolkit, AI/ML, etc.)
- **Show install instructions** — the exact JSON config or file path, ready to copy
- **Suggest the CLI** — `npx codeguilds install <slug>` for one-command installs
## Install
Add to `~/.claude/settings.json`:
```json
{
"mcpServers": {
"codeguilds": {
"command": "npx",
"args": ["-y", "@codeguilds/mcp-server"]
}
}
}
```
Then restart Claude Code. Verify with `/mcp` — you should see `codeguilds` listed as connected.
## Example conversations
> "Find me an MCP server for Notion"
> "What's the best code review skill in the registry?"
> "Show me the React & Next.js dev collection"
> "How do I install context7?"
> "I need a hook that runs tests before Claude commits"
Claude will call the registry automatically whenever your request is about finding or installing Claude Code extensions.
## Tools
| Tool | Description |
|------|-------------|
| `search_packages` | Search by keyword, optionally filtered by type |
| `get_package` | Full details for a package by slug |
| `list_collections` | All featured curated collections |
| `get_collection` | Packages inside a specific collection |
| `get_install_instructions` | Step-by-step install config for any package |
## Package types
| Type | What it is |
|------|-----------|
| `mcp_server` | MCP server — adds new tools to Claude |
| `skill` | Slash command (`/my-skill`) |
| `agent` | Subagent with its own instructions |
| `hook` | Shell command triggered on Claude events |
| `prompt` | Reusable prompt template |
| `claude_md_template` | CLAUDE.md snippet to merge into your project |
## Requirements
- Node.js 18+
- Claude Code
## Links
- [CodeGuilds registry](https://codeguilds.dev)
- [MCP page & docs](https://codeguilds.dev/mcp)
- [CLI tool](https://codeguilds.dev/cli) — `npx codeguilds install <slug>`
- [GitHub](https://github.com/xdevsapps/codeguilds-mcp)
## License
MIT