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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | Yes | Server category to list (e.g., 'browser', 'cloud', 'command_line', 'communication', 'database', 'developer', 'filesystem', 'search', 'all') |
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: "🛠️" };