Back to Browse

Country Generator MCP Server

by James Callum East
Education & ResearchModerate6.0RemoteNew
Free

Random countries, flags, capitals and geography quizzes for AI assistants

About

Country Generator brings countrygenerator.com to your AI assistant. Generate a random country and get its flag, capital, population, region and map details, or pull facts about any country by name. It can also run geography quizzes on flags, capitals, country shapes, populations and borders right in the chat. It's a remote server, so there's nothing to install: just connect to the endpoint. Great for students, teachers, trivia fans, travellers looking for inspiration and anyone building geography games or learning tools.

Security Report

6.0
Moderate6.0Moderate Risk

No server source code was provided, only a README describing a hosted, read-only, unauthenticated Streamable HTTP endpoint for country and quiz lookups. The stated purpose fits the network_http permission, but the implementation cannot be verified, so the score is capped in the fair range. The main open items are unverified server-side behavior and a documentation mismatch about where the code lives.

1 file analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "country-generator": {
      "url": "https://countrygenerator.com/mcp"
    }
  }
}

Getting Started

Once installed, try these example prompts and explore these capabilities:

  • 1"Give me a random country with its flag and capital"
  • 2"What is the capital and population of Portugal?"
  • 3"Quiz me on European flags"
  • 4"Pick a random country in Africa for my next trip idea"
  • 5"Start a capitals quiz with 10 questions"

Documentation

View on GitHub

From the project's GitHub README.

Country Generator MCP Server

Look up any country's capital, population and borders, or play geography quizzes with your AI.

This repository holds the documentation and registration metadata for the hosted server. The server itself runs at countrygenerator.com.

  • Endpoint: https://countrygenerator.com/mcp
  • Transport: Streamable HTTP
  • Authentication: None
  • Documentation: countrygenerator.com/mcp

Tools

ToolWhat it does
get_countryFacts about one country: capital, region, population, area, languages, currencies, driving side and neighbours.
search_countriesLists countries by part of a name or capital, by continent, or landlocked only.
random_countryPicks a random country, optionally from one continent.
compare_populationRanks 2 to 4 countries by population.
get_bordersLists the countries that share a land border with a country.
create_quizCreates questions on flags, capitals, country outlines, population or neighbours.
check_answerChecks one quiz answer and returns the right answer, some facts and the new score.

Every tool is read-only. Names and answers work in English, German, Spanish, French, Portuguese, Japanese and Italian. Country lookups accept a name in any of those languages or an ISO code.

Each quiz question carries an encrypted ticket that holds the answer, so the assistant cannot give it away early. A run ends after three wrong answers. Quizzes have easy, medium and hard levels and can be limited to one continent.

The server also has a quiz_me prompt for clients that show prompts.

Connect

Claude

  1. Open Customize, then Connectors.
  2. Select + Add, then Add custom connector.
  3. Enter Country Generator as the name and https://countrygenerator.com/mcp as the URL, then select Continue.
  4. Under Authentication, choose No sign in, then select Add.

Claude Code

claude mcp add --transport http country-generator https://countrygenerator.com/mcp

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "country-generator": {
      "url": "https://countrygenerator.com/mcp"
    }
  }
}

VS Code

Add this to .vscode/mcp.json:

{
  "servers": {
    "country-generator": {
      "type": "http",
      "url": "https://countrygenerator.com/mcp"
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/countrygenerator/mcp-server

ChatGPT

  1. Open ChatGPT Plugins in your browser.
  2. Select the plus button, then Add custom MCP server.
  3. Enter Country Generator as the name and https://countrygenerator.com/mcp as the server URL.
  4. Review the permissions and warning, then select Create as a plugin.
  5. Install the resulting plugin, start a new conversation and select it using @.

Grok

  1. Open Grok Connectors.
  2. Select New Connector, then Custom.
  3. Enter https://countrygenerator.com/mcp as the MCP server URL. This server requires no authentication.
  4. Complete the setup to make the tools available in conversations.

Other MCP clients

Where custom remote MCP connections are available, use https://countrygenerator.com/mcp with Streamable HTTP.

Example prompts

  • What is the capital of Kazakhstan, and which countries border it?
  • Which has more people: Nigeria, Brazil or Japan?
  • Quiz me on African flags, hard mode.
  • Give me 10 capital questions about Asia, in German.

Limits

To maintain service stability, security, and fair usage, the API enforces server-side rate limiting and request validation.

  • Rate Limiting: Requests are subject to usage restrictions to prevent excessive traffic and automated abuse.
  • Limit Exceeded: Requests exceeding permitted thresholds receive an HTTP 429 Too Many Requests response with a Retry-After header.
  • Quiz Generation: The create_quiz endpoint enforces request and question-generation limits.
  • Ticket Validity: Quiz tickets are temporary and automatically expire after a predefined period.
  • Abuse Prevention: Additional restrictions may be applied to suspicious or excessive activity.

Support

For bug reports and questions, open an issue.

Reviews

No reviews yet

Be the first to review this server!