🌍 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