list_servers
Retrieve a list of available MCP servers filtered by category, such as cloud, database, or developer, to streamline server selection and installation processes.
Instructions
List available MCP servers by category
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | Yes | Server category to list (e.g., 'browser', 'cloud', 'command_line', 'communication', 'database', 'developer', 'filesystem', 'search', 'all') |
Input Schema (JSON Schema)
{
"properties": {
"category": {
"description": "Server category to list (e.g., 'browser', 'cloud', 'command_line', 'communication', 'database', 'developer', 'filesystem', 'search', 'all')",
"enum": [
"browser",
"cloud",
"command_line",
"communication",
"customer_data",
"database",
"developer",
"data_science",
"filesystem",
"finance",
"knowledge",
"location",
"monitoring",
"search",
"security",
"compliance",
"travel",
"version_control",
"other",
"all"
],
"type": "string"
}
},
"required": [
"category"
],
"type": "object"
}
Implementation Reference
- src/index.ts:440-511 (handler)Handler function that executes the 'list_servers' tool. It takes a category argument, formats and returns a list of MCP servers from the serverCategories object, with special handling for 'all' category.if (name === "list_servers" && args) { const category = (args.category as string).toLowerCase(); const categoryEmojis: Record<string, string> = { browser: "📂", cloud: "☁️", command_line: "🖥️", communication: "💬", customer_data: "👤", database: "🗄️", developer: "🛠️", data_science: "🧮", filesystem: "📂", finance: "💰", knowledge: "🧠", location: "🗺️", monitoring: "📊", search: "🔎", security: "🔐", compliance: "🔒", travel: "🚆", version_control: "🔄", other: "🛠️" }; if (category === "all") { const allServers = Object.entries(serverCategories) .map(([cat, servers]) => { const emoji = categoryEmojis[cat] || "📦"; const formattedCategory = cat .split('_') .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()) .join(' '); const serverList = servers .map(server => `- ${server}`) .join('\n'); return `\n## ${emoji} ${formattedCategory}\n\n${serverList}`; }) .join('\n'); return { content: [{ type: "text", text: `# Available MCP Servers by Category${allServers}` }] }; } const servers = serverCategories[category]; if (!servers) { return { content: [{ type: "text", text: `Unknown category: "${category}". Available categories: ${Object.keys(serverCategories).join(", ")}` }] }; } const emoji = categoryEmojis[category] || "📦"; const formattedCategory = category .split('_') .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()) .join(' '); return { content: [{ type: "text", text: `# ${emoji} ${formattedCategory} Servers\n\n${servers.map(server => `- ${server}`).join('\n')}` }] }; }
- src/index.ts:286-300 (schema)Schema definition for the 'list_servers' tool, specifying the input parameter 'category' with allowed enum values.{ name: "list_servers", description: "List available MCP servers by category", inputSchema: { type: "object", properties: { category: { type: "string", description: "Server category to list (e.g., 'browser', 'cloud', 'command_line', 'communication', 'database', 'developer', 'filesystem', 'search', 'all')", enum: ["browser", "cloud", "command_line", "communication", "customer_data", "database", "developer", "data_science", "filesystem", "finance", "knowledge", "location", "monitoring", "search", "security", "compliance", "travel", "version_control", "other", "all"] } }, required: ["category"] } }
- src/index.ts:255-303 (registration)Registration of available tools via ListToolsRequestHandler, including the 'list_servers' tool in the returned tools list.server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: [ { name: "explain_concept", description: "Get a beginner-friendly explanation of an MCP concept", inputSchema: { type: "object", properties: { concept: { type: "string", description: "The MCP concept to explain (e.g., 'tools', 'resources', 'prompts', 'server', 'client', 'server_types', 'frameworks', 'clients')", } }, required: ["concept"] } }, { name: "show_example", description: "Show a practical example of an MCP feature", inputSchema: { type: "object", properties: { feature: { type: "string", description: "The MCP feature to demonstrate (e.g., 'tool_call', 'resource_read', 'prompt_template')", } }, required: ["feature"] } }, { name: "list_servers", description: "List available MCP servers by category", inputSchema: { type: "object", properties: { category: { type: "string", description: "Server category to list (e.g., 'browser', 'cloud', 'command_line', 'communication', 'database', 'developer', 'filesystem', 'search', 'all')", enum: ["browser", "cloud", "command_line", "communication", "customer_data", "database", "developer", "data_science", "filesystem", "finance", "knowledge", "location", "monitoring", "search", "security", "compliance", "travel", "version_control", "other", "all"] } }, required: ["category"] } } ] }; });
- src/index.ts:29-252 (helper)Data structure containing categorized lists of available MCP servers, used by the list_servers tool.const serverCategories: Record<string, string[]> = { "browser": [ "@automatalabs/mcp-server-playwright - Browser automation with Playwright", "@browserbase/mcp-server-browserbase - Browser automation and web interaction", "@browserbasehq/mcp-stagehand - Cloud browser automation capabilities", "@executeautomation/playwright-mcp-server - Browser automation and webscraping", "@it-beard/exa-server - Intelligent code search using Exa API", "@kimtaeyoon83/mcp-server-youtube-transcript - YouTube subtitles and transcripts", "@kimtth/mcp-aoai-web-browsing - Azure OpenAI and web browsing integration", "@modelcontextprotocol/server-puppeteer - Browser automation for web scraping", "@recursechat/mcp-server-apple-shortcuts - Apple Shortcuts integration" ], "cloud": [ "@aws/kb-retrieval-mcp - Retrieval from AWS Knowledge Base using Bedrock Agent Runtime", "@cloudflare/mcp-server-cloudflare - Integration with Cloudflare services", "@flux159/mcp-server-kubernetes - Kubernetes operations for pods and services", "@rishikavikondala/mcp-server-aws - AWS resource operations using LLM", "@SmallCloudCo/smallcloud-mcp-server - Cloud service integration demonstration", "@strowk/mcp-k8s-go - Kubernetes cluster operations through MCP" ], "command_line": [ "@g0t4/mcp-server-commands - Run any command with run_command and run_script tools", "@mladensu/cli-mcp-server - Command line interface with secure execution", "@PhialsBasement/CMD-MCP-Server - Secure command execution with analytics", "@simonb97/win-cli-mcp-server - Windows-specific CLI operations", "@tumf/mcp-shell-server - Secure shell command execution" ], "communication": [ "@enescinr/twitter-mcp - Interact with Twitter API", "@hannesrudolph/imessage-query-fastmcp - iMessage database access and search", "@keturiosakys/bluesky-context-server - Bluesky integration with feed search", "@markelaugust74/mcp-google-calendar - Google Calendar event management", "@markuspfundstein/mcp-gsuite - Gmail and Google Calendar integration", "@modelcontextprotocol/server-bluesky - Bluesky instance integration", "@modelcontextprotocol/server-slack - Slack workspace integration", "@vidhupv/x-mcp - Create and manage X/Twitter posts" ], "customer_data": [ "@ivo-toby/contentful-mcp - Content management in Contentful spaces", "@opendatamcp/opendatamcp - Connect Open Data to LLMs", "@sergehuber/inoyu-mcp-unomi-server - Apache Unomi CDP integration", "@tinybirdco/mcp-tinybird - Tinybird Workspace interaction" ], "database": [ "@aekanun2020/mcp-server - MSSQL database integration", "@benborla/mcp-server-mysql - MySQL database integration (NodeJS)", "@cyanheads/atlas-mcp-server - Atlas database integration", "@designcomputer/mysql_mcp_server - MySQL database integration", "@ergut/mcp-bigquery-server - Google BigQuery integration", "@isaacwasserman/mcp-snowflake-server - Snowflake database integration", "@joshuarileydev/supabase-mcp-server - Supabase integration", "@kashiwabyte/vikingdb-mcp-server - VikingDB vector store integration", "@kiliczsh/mcp-mongo-server - MongoDB integration server", "@ktanaka101/mcp-server-duckdb - DuckDB integration", "@lucashild/mcp-server-bigquery - BigQuery integration", "@modelcontextprotocol/server-postgres - PostgreSQL integration", "@modelcontextprotocol/server-sqlite - SQLite operations", "@neo4j-contrib/mcp-neo4j - Neo4j graph database integration", "@quantgeekdev/mongo-mcp - MongoDB LLM integration", "@qdrant/mcp-server-qdrant - Qdrant vector database", "@surrealdb/surrealist-mcp - SurrealDB database integration", "@tinybirdco/mcp-tinybird - Tinybird integration" ], "developer": [ "@Alec2435/python_mcp - Run Python code locally", "@dabouelhassan/mcp-server-example-v2 - FastAPI example server", "@e2b-dev/mcp-server - Code execution with E2B", "@emiryasar/mcp_code_analyzer - Code analysis tools", "@ggoodman/mcp - CLI and UI for MCP servers", "@jetbrains/mcpproxy - JetBrains IDE integration", "@joshuarileydev/ios-simulator-controller - iOS simulator control", "@joshrutkowski/applescript-mcp - macOS AppleScript integration", "@justjoehere/mcp_gradio_client - Gradio integration", "@mcp-get/server-curl - HTTP request interface", "@mcp-get/server-llm-txt - LLM.txt content search", "@mcp-get/server-macos - macOS system operations", "@mkearl/dependency-mcp - Dependency graph analysis", "@nguyenvanduocit/all-in-one-devtools - Development tools collection", "@oatpp/oatpp-mcp - C++ MCP integration", "@quantgeekdev/docker-mcp - Docker management", "@rmrf2020/decision-mind - Decision making demo", "@seanivore/mcp-code-analyzer - Python code analysis", "@shanejonas/openrpc-mpc-server - JSON-RPC API integration", "@snaggle-ai/openapi-mcp-server - OpenAPI integration", "@szeider/mcp-solver - MiniZinc constraint solving", "@tumf/mcp-text-editor - Text editor integration", "@vijayk-213/model-context-protocol - LLaMA integration", "@zeparhyfar/mcp-datetime - DateTime handling" ], "data_science": [ "@reading-plus-ai/mcp-server-data-exploration - CSV data exploration", "@vivekvells/mcp-pandoc - Document format conversion" ], "filesystem": [ "@apeyroux/mcp-xmind - XMind file operations", "@isaacphi/mcp-gdrive - Google Drive integration", "@kazuph/mcp-pocket - Pocket articles integration", "@mark3labs/mcp-filesystem-server - Golang filesystem implementation", "@modelcontextprotocol/server-filesystem - Local filesystem access", "@modelcontextprotocol/server-google-drive - Google Drive integration", "@RafalWilinski/mcp-apple-notes - Apple Notes RAG integration" ], "finance": [ "@9nate-drake/mcp-yfinance - Yahoo Finance integration", "@Alec2435/amazon-fresh-server - Amazon Fresh integration", "@anjor/coinmarket-mcp-server - Coinmarket API integration", "@calvernaz/alphavantage - AlphaVantage market data", "@quantgeekdev/coincap-mcp - CoinCap cryptocurrency data", "@sammcj/bybit-mcp - Bybit exchange integration" ], "knowledge": [ "@chemiguel23/memorymesh - Enhanced graph-based memory", "@modelcontextprotocol/server-memory - Knowledge graph system", "@run-llama/mcp-server-llamacloud - LlamaCloud integration", "@shaneholloman/mcp-knowledge-graph - Local knowledge graph", "@Synaptic-Labs-AI/claudesidian - Second brain integration", "@topoteretes/cognee-mcp-server - GraphRAG memory server" ], "location": [ "@modelcontextprotocol/server-google-maps - Google Maps integration", "@mstfe/google-task-mcp - Google Tasks integration" ], "monitoring": [ "@macrat/mcp-ayd-server - Ayd monitoring service", "@metoro-io/metoro-mcp-server - Kubernetes monitoring", "@modelcontextprotocol/server-raygun - Raygun monitoring", "@modelcontextprotocol/server-sentry - Sentry.io integration", "@ruchernchong/mcp-server-google-analytics - Analytics integration", "@Sladey01/mcp-snyk - Snyk security scanning", "@sunsetcoder/flightradar24-mcp-server - Flight tracking", "@tevonsb/homeassistant-mcp - Home Assistant control" ], "search": [ "@ac3xx/mcp-servers-kagi - Kagi search integration", "@ahonn/mcp-server-gsc - Google Search Console access", "@andybrandt/mcp-simple-arxiv - ArXiv paper search", "@andybrandt/mcp-simple-pubmed - PubMed paper search", "@angheljf/nyt - NYTimes article search", "@apify/mcp-server-rag-web-browser - Web content search", "@blazickjp/arxiv-mcp-server - ArXiv research papers", "@dmayboroda/minima - Local RAG implementation", "@exa-labs/exa-mcp-server - Exa AI Search", "@fatwang2/search1api-mcp - Search1API integration", "@it-beard/tavily-server - Tavily AI search", "@laksh-star/mcp-server-tmdb - Movie and TV data", "@modelcontextprotocol/server-brave-search - Brave Search", "@modelcontextprotocol/server-fetch - Web content fetching", "@mzxrai/mcp-webresearch - Google search integration", "@secretiveshell/searxng-search - SearXNG integration", "@tomatio13/mcp-server-tavily - Tavily search API", "@vrknetha/mcp-server-firecrawl - Web scraping", "@wong2/mcp-jina-reader - URL to Markdown conversion" ], "security": [ "@axiomhq/mcp-server-axiom - Axiom platform integration", "@burtthecoder/maigret - OSINT username search", "@burtthecoder/shodan - Shodan security search", "@burtthecoder/virustotal - VirusTotal analysis" ], "compliance": [ "@dynamicendpoints/bod-25-01-cisa-mcp - CISA security requirements" ], "travel": [ "@r-huijts/ns-mcp-server - Dutch Railways information" ], "version_control": [ "@block/goose-mcp - GitHub operations automation", "@modelcontextprotocol/server-git - Git operations", "@modelcontextprotocol/server-github - GitHub API integration", "@modelcontextprotocol/server-gitlab - GitLab integration" ], "other": [ "@aliargun/mcp-server-gemini - Google Gemini integration", "@amidabuddha/unichat-mcp-server - Multi-provider LLM integration", "@anaisbetts/mcp-installer - MCP server installer", "@anaisbetts/mcp-youtube - YouTube subtitles", "@andybrandt/mcp-simple-openai-assistant - OpenAI assistants", "@andybrandt/mcp-simple-timeserver - Time service", "@baba786/phabricator-mcp-server - Phabricator integration", "@bartolli/mcp-llm-bridge - OpenAI-compatible LLMs", "@calclavia/mcp-obsidian - Markdown notes", "@ccabanillas/notion-mcp - Notion API integration", "@chatmcp/mcp-server-chatsum - Chat analysis", "@danhilse/notion_mcp - Notion API integration", "@dgormly/mcp-financial-advisor - Financial advisory", "@DMontgomery40/mcp-canvas-lms - Canvas LMS integration", "@domdomegg/airtable-mcp-server - Airtable integration", "@evalstate/mcp-miro - MIRO whiteboard access", "@felores/airtable-mcp - Airtable integration", "@future-audiences/wikimedia-enterprise-mcp - Wikipedia lookup", "@isaacwasserman/mcp-vegalite-server - Data visualization", "@jerhadf/linear-mcp-server - Linear project management", "@jimpick/fireproof-todo-mcp - Fireproof todo list", "@joshuarileydev/app-store-connect - App Store integration", "@lightconetech/mcp-gateway - SSE Server gateway", "@llmindset/mcp-hfspace - HuggingFace Spaces", "@markuspfundstein/mcp-obsidian - Obsidian REST API", "@MCP-Club/mcpm - MCP server manager", "@mikeskarl/mcp-prompt-templates - Analysis templates", "@modelcontextprotocol/server-everything - MCP features demo", "@mrjoshuak/godoc-mcp - Go documentation", "@mzxrai/mcp-openai - OpenAI chat integration", "@navisbio/clinicaltrials-mcp - ClinicalTrials.gov data", "@patruff/claude-mcp-setup - Windows MCP setup", "@patruff/ollama-mcp-bridge - Ollama LLM integration", "@pierrebrunelle/mcp-server-openai - OpenAI integration", "@pyroprompts/any-chat-completions-mcp - OpenAI API", "@reeeeemo/ancestry-mcp - Genealogy data", "@rusiaaman/wcgw - Shell execution (Mac)", "@sammcj/package-version - Package management", "@sirmews/apple-notes-mcp - Apple Notes access", "@sirmews/mcp-pinecone - Pinecone vector DB", "@skydeckai/mcp-server-rememberizer - Knowledge retrieval", "@smithery-ai/mcp-obsidian - Obsidian vault integration", "@sooperset/mcp-atlassian - Confluence integration", "@suekou/mcp-notion-server - Notion integration", "@tanigami/mcp-server-perplexity - Perplexity API", "@v-3/notion-server - Notion management", "@varunneal/spotify-mcp - Spotify playback", "@wong2/litemcp - TypeScript MCP framework", "@wong2/mcp-cli - MCP testing tool", "@zueai/mcp-manager - MCP server management UI" ] };
- src/index.ts:442-462 (helper)Mapping of categories to emojis for formatting the output of list_servers tool.const categoryEmojis: Record<string, string> = { browser: "📂", cloud: "☁️", command_line: "🖥️", communication: "💬", customer_data: "👤", database: "🗄️", developer: "🛠️", data_science: "🧮", filesystem: "📂", finance: "💰", knowledge: "🧠", location: "🗺️", monitoring: "📊", search: "🔎", security: "🔐", compliance: "🔒", travel: "🚆", version_control: "🔄", other: "🛠️" };