# Search Registry

Search the MCP Gateway Registry using semantic search.

- Repository: https://github.com/agentic-community/mcp-gateway-registry (1032 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentic-community/mcp-gateway-registry --skill search-registry -g -a claude-code -y`
Codex: `npx skills add agentic-community/mcp-gateway-registry --skill search-registry -g -a codex -y`
Cursor: `npx skills add agentic-community/mcp-gateway-registry --skill search-registry -g -a cursor -y`
Gemini CLI: `npx skills add agentic-community/mcp-gateway-registry --skill search-registry -g -a gemini-cli -y`

## Description

Search the MCP Gateway Registry using semantic search. Takes a natural language query, calls the /api/search/semantic endpoint, and returns formatted results directly in the conversation.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Search Registry Skill

Search the MCP Gateway Registry for MCP servers, tools, A2A agents, skills, and virtual servers using the ai-registry-tools MCP server.

## Prerequisites

The user must have the AI Registry MCP server connected to their AI Assistant session. It may be registered under various names including:

- `ai-registry-tools`
- `airegistry-tools`
- `ai_registry_tools`
- `registry-tools`
- `mcp-registry`

The key indicator is that one of these tools should be available:
- `mcp__ai-registry-tools__search_registry`
- `mcp__airegistry-tools__search_registry`
- or similar variations

## Input

The skill accepts a natural language search query:

```
/search-registry <query>
```

- **query** - What capability, tool, server, or agent the user is looking for (natural language)

If no query is provided, ask the user: "What would you like to search for in the registry?"

### Examples

```
/search-registry tools for weather data
/search-registry exchange rates currency conversion
/search-registry document processing PDF
/search-registry travel booking flights
```

## Workflow

### Step 1: Find the Registry Search Tool

Look for the `search_registry` tool from the ai-registry-tools MCP server. It may be available under different prefixes depending on how the user registered the server. Try these in order:

1. `mcp__ai-registry-tools__search_registry`
2. `mcp__airegistry-tools__search_registry`
3. `mcp__ai_registry_tools__search_registry`
4. `mcp__registry-tools__search_registry`
5. `mcp__mcp-registry__search_registry`

Use ToolSearch to find the correct tool name if none of the above work. Search for "search_registry" or "registry search".

If the tool cannot be found, tell the user:
> "The AI Registry MCP server is not connected to this AI Assistant session. You need to add it first. See the registry documentation for connection instructions specific to your AI Assistant (Claude Code, Codex CLI, etc.)."

### Step 2: Execute the Search

The rest: https://github.com/agentic-community/mcp-gateway-registry/blob/HEAD/.claude/skills/search-registry/SKILL.md