🌍 Countries MCP Server
A Model Context Protocol (MCP) server that gives AI assistants access to comprehensive country data from 250+ countries.
Wraps the REST Countries API v3.1 — a free, open-source API serving data on 250+ countries. No API key required. The MCP server exposes 13 tools for searching, filtering, comparing, and exploring country data — optimized for AI consumption.
✨ Features
| Category | Tools | What AI Can Do |
|---|---|---|
| 🔍 Lookup | 3 tools | Get country by name, code, or exact full name |
| 🔎 Search | 3 tools | Find by currency, language, or capital city |
| 🌐 Filter | 3 tools | Filter by region, subregion, or demonym |
| 📦 Bulk | 2 tools | Get all countries or multiple by codes |
| ⚖️ Compare | 1 tool | Side-by-side country comparison |
| 🗺️ Neighbors | 1 tool | Discover bordering countries |
📦 Packages
| Package | Description | Docs |
|---|---|---|
countries-mcp-server |
MCP server (npm package) | Server README → |
countries-mcp-vscode |
VS Code extension | Extension README → |
🚀 Quick Start
VS Code Extension (recommended)
Install from the VS Code Marketplace or search "Countries MCP" in Extensions. The MCP server appears automatically in VS Code's MCP servers list with start/stop/restart controls.
npm (standalone)
npm install -g countries-mcp-server
Then add to your AI client's MCP configuration. See the Server README for details.
📄 License
MIT © bhayanak
