add-mcp-server

Generate compliant server.json and icon.svg files for MCP registry onboarding.

21|28|Updated Aug 11, 2025
One-click install
npx skills add https://github.com/stacklok/toolhive-catalog --skill add-mcp-server-stacklok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-mcp-server
Source: https://github.com/stacklok/toolhive-catalog/tree/main/.claude/skills/add-mcp-server
Command: npx skills add https://github.com/stacklok/toolhive-catalog --skill add-mcp-server-stacklok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Add new MCP server entries to the ToolHive registry by generating properly structured server.json and icon.svg files, ensuring they conform to the MCP schema, and including correct _meta extensions and validation.

Core Features & Use Cases

  • Generate a compliant server.json for new MCP servers (container or remote) with the correct schema, version pinning, and _meta alignment.
  • Create an icon.svg for the server entry and validate the overall registry metadata.
  • Provide a guided workflow for onboarding MCP servers or writing server.json, including naming, repository details, and provenance data.

Quick Start

Provide the server details (name, type, repository, and metadata) to generate a compliant server.json and icon.svg for a new MCP server entry.

Frequently Asked Questions about add-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a compliant server.json file for an MCP registry?

To create a compliant server.json file for an MCP registry, you need to ensure proper schema adherence, version pinning, and correct _meta extensions for provenance metadata. The add-mcp-server Skill automates generating this structured file for both container and remote servers.

What is the proper structure for MCP server onboarding metadata?

MCP server onboarding metadata requires a structured server.json that includes naming conventions, repository details, version pins, and aligned _meta extensions. It also needs an icon.svg file to complete the registry entry and pass validation.

How do I add a container-based MCP server to ToolHive?

To add a container-based MCP server to ToolHive, provide the server name, type, repository, and metadata details. The onboarding workflow will generate the required server.json and icon.svg files while enforcing naming rules and validating the final schema.

Do I need an icon.svg file to validate my MCP registry entry?

Yes, an icon.svg file is required to validate your MCP registry entry. The onboarding process creates the icon reference and validates the overall registry metadata alongside the server.json file to ensure full schema compliance.

Does the MCP registry schema support remote servers?

Yes, the MCP registry schema supports remote servers. The generation workflow covers both container-based and remote server types, guiding naming, templating, and validation to ensure proper _meta extensions and provenance metadata alignment.

Why does my MCP server.json fail schema validation?

Your MCP server.json might fail schema validation due to misaligned _meta extensions, missing provenance metadata, incorrect naming rules, or unpinned version numbers. The onboarding workflow enforces these rules to ensure the final JSON conforms to the server schema.