list_mcps
Discover available MCP servers in the registry, filter by category, or view essential options for installation across multiple development clients.
Instructions
List all available MCPs in the registry. Can filter by category or show only essential MCPs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | Filter by category (e.g., "Audio", "Development", "MCP Management") | |
| essential_only | No | Only show MCPs marked as essential |
Implementation Reference
- src/index.ts:186-212 (handler)Executes the list_mcps tool by calling the helper listMcps function with input arguments, formatting the MCP list with additional computed fields like requires_secrets, and returning formatted JSON as text content.
case 'list_mcps': { const mcps = await listMcps({ category: args?.category as string | undefined, essentialOnly: args?.essential_only as boolean | undefined }); const formatted = mcps.map(mcp => ({ id: mcp.id, name: mcp.name, description: mcp.description, category: mcp.category, type: mcp.type, essential: mcp.essential || false, requires_secrets: (mcp.secrets?.length || 0) > 0, secret_keys: mcp.secrets?.map(s => s.key) || [] })); return { content: [{ type: 'text', text: JSON.stringify({ count: formatted.length, mcps: formatted }, null, 2) }] }; } - src/index.ts:38-54 (schema)JSON Schema for the input parameters of the list_mcps tool, defining optional category filter and essential_only boolean flag.
{ name: 'list_mcps', description: 'List all available MCPs in the registry. Can filter by category or show only essential MCPs.', inputSchema: { type: 'object', properties: { category: { type: 'string', description: 'Filter by category (e.g., "Audio", "Development", "MCP Management")' }, essential_only: { type: 'boolean', description: 'Only show MCPs marked as essential', default: false } } } - src/index.ts:176-178 (registration)Registers the list_mcps tool (and others) with the MCP server by providing the tools list in response to ListToolsRequestSchema.
server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools })); - src/registry.ts:167-188 (helper)Helper function listMcps that retrieves the MCP registry and applies filters based on category, essentialOnly, and enabledOnly options before returning the filtered list of MCP entries.
export async function listMcps(options?: { category?: string; essentialOnly?: boolean; enabledOnly?: boolean; }): Promise<McpEntry[]> { const registry = await getRegistry(); let mcps = registry.mcps; if (options?.category) { mcps = mcps.filter(mcp => mcp.category?.toLowerCase() === options.category?.toLowerCase()); } if (options?.essentialOnly) { mcps = mcps.filter(mcp => mcp.essential === true); } if (options?.enabledOnly !== false) { mcps = mcps.filter(mcp => mcp.enabled !== false); } return mcps; }