search-registry

Search the MCP Gateway Registry semantically and add discovered MCP servers to AI assistant configurations.

892|225|Updated May 29, 2025
One-click install
npx skills add https://github.com/agentic-community/mcp-gateway-registry --skill search-registry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: search-registry
Source: https://github.com/agentic-community/mcp-gateway-registry/tree/main/.claude/skills/search-registry
Command: npx skills add https://github.com/agentic-community/mcp-gateway-registry --skill search-registry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finding the right MCP server, tool, agent, or skill across a large registry is difficult without a unified search interface, and manually wiring discovered servers into an AI assistant's configuration is error-prone.

Core Features & Use Cases

  • Semantic Registry Search: Runs natural language queries against the registry's search_registry tool and returns formatted results across MCP servers, tools, A2A agents, and skills.
  • Guided Server Onboarding: Detects which AI assistant is in use (Claude Code, Codex CLI, or others) and adds a selected server's endpoint to the correct MCP configuration file.
  • Catalog Fallback: Falls back to listing the full catalog with list_services, list_agents, and list_skills when semantic search returns no matches.
  • Use Case: A developer asks for "tools for weather data", reviews the ranked results, picks a server, and has it added to ~/.claude.json ready for the next session.

Quick Start

Ask the assistant to search the registry for the capability you need, for example: search the registry for document processing tools.

Frequently Asked Questions about search-registry

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

FAQPage Schema
How do I search the MCP Gateway Registry for servers and tools?

Invoke the skill with a natural language query describing the capability you need. It calls the search_registry tool from the ai-registry-tools MCP server and returns ranked results across servers, tools, agents, and skills.

How do I add a discovered MCP server to Claude Code?

After search results appear, confirm which server you want and the skill runs claude mcp add with the server's endpoint URL, or updates ~/.claude.json directly. The server is saved at user scope and becomes available in a new session.

What happens if the ai-registry-tools MCP server is not connected?

The skill checks for the search_registry tool under several common server name prefixes. If none is found, it tells you the registry server is not connected and points you to the connection instructions for your AI assistant.

What can I do when semantic search returns no results?

The skill falls back to browsing the full catalog using list_services, list_agents, and list_skills. You can review the unfiltered listings and pick a server or skill of interest from there.

Does adding a new MCP server take effect immediately?

No. After the server is added to your assistant's MCP configuration, you must start a new session before its tools become available. The skill explicitly informs you of this requirement after a successful addition.