MCP Tool Registry Manager

Manage MCP (Model Context Protocol) tools from the MCP Tool Shop registry. This skill helps you install, configure, validate, and manage tools that extend AI capabilities through the Model Context Protocol.

What This Skill Does

The MCP Tool Registry Manager allows you to:

Key Concepts

**Registry Architecture:**

**Security Model:**

**Version Pinning:**

Step-by-Step Instructions

1. Initialize MCP Workspace

When the user wants to start using MCP tools:

1. Ask which registry version to pin (recommend latest stable tag like v0.1.0)

2. Run initialization command:

```bash

mcpt init --registry-ref v0.1.0

```

3. Verify the created `mcp.yaml` configuration file

4. Explain that this pins the registry metadata, not individual tool versions

2. Install Individual Tools

When the user wants to add a specific tool:

1. List available tools from the registry if needed:

```bash

mcpt list

```

2. Install the tool:

```bash

mcpt add <tool-id>

```

3. To pin a specific tool version:

```bash

mcpt add <tool-id> --ref v1.0.0

```

4. Verify installation and explain the tool's capabilities

3. Install Tool Bundles

When the user wants a curated collection:

1. Explain the available bundles:

- **core**: Essential utilities

- **agents**: Agent orchestration tools

- **ops**: Operations and infrastructure tools

2. Install the bundle:

```bash

mcpt add --bundle core

```

3. List installed tools to confirm

4. Validate Registry Schema

When working with registry.json locally:

1. Navigate to the registry directory

2. Run validation:

```bash

npx ajv validate -s schema/registry.schema.json -d registry.json

```

3. Check for validation errors and explain any issues found

5. View Available Registry Tags

To see stable releases:

```bash

git tag -l

```

Explain the difference between tags (stable) and main (development).

6. Add a New Tool to Registry

When contributing a new tool:

1. Read the existing `registry.json` structure

2. Create a new tool entry with required fields:

- `id`: kebab-case identifier

- `name`: Human-readable name

- `description`: Clear description of functionality

- `repo`: GitHub repository URL

- `install`: Installation configuration

- `tags`: Searchable tags

- `defaults` (optional): Default settings like `safe_run`

3. Validate against schema:

```bash

npx ajv validate -s schema/registry.schema.json -d registry.json

```

4. Commit changes and prepare PR

Examples

**Example 1: Initialize workspace with stable registry**

```bash

mcpt init --registry-ref v0.1.0

```

**Example 2: Install file-compass tool with pinned version**

```bash

mcpt add file-compass --ref v2.0.0

```

**Example 3: Install core utilities bundle**

```bash

mcpt add --bundle core

```

**Example 4: Validate registry locally**

```bash

npx ajv validate -s schema/registry.schema.json -d registry.json

```

Important Notes

Common Workflows

**Getting started:**

1. Initialize workspace with stable registry tag

2. Install core bundle for essential tools

3. Add specific tools as needed for your workflow

**Contributing:**

1. Fork the registry repo

2. Add tool entry to registry.json

3. Validate against schema

4. Submit PR with clear description

**Production use:**

1. Pin registry to stable tag

2. Pin individual tools to specific versions

3. Document all installed tools and versions

4. Test before deployment

Constraints