API & MCP

Everything a person can do on Cartograph Country Quiz (capitals, flags, shapes, map — printable), a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://cartographcountryquiz.usefulweb.site/api/v1/calculate – run Cartograph Country Quiz (capitals, flags, shapes, map — printable)
GET https://cartographcountryquiz.usefulweb.site/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Cartograph Country Quiz (capitals, flags, shapes, map — printable)

Makes a multiple-choice geography quiz for a region or the whole world: capitals, countries of capitals, flags, country shapes, or “find it on the map”. The same seed always gives the same questions, so a class can share one quiz. You get the questions with the answer key, a printable PDF quiz sheet (flag questions print the flag’s written description, map questions print a numbered blank map), and Markdown flashcards for Deckwright Study Cards. It is the quiz engine of the Cartograph app, which also schedules spaced reviews.

Inputs of Cartograph Country Quiz (capitals, flags, shapes, map — printable)
Field	Type	Default	Description
`kind`	select (capital, country, flag, shape, locate)	"capital"	Quiz
`region`	select (world, africa, asia, europe, north-america, south-america, oceania)	"europe"	Region
`count`	integer	10	Questions
`choices`	integer	4	Choices per question
`seed`	text	"atlas"	Seed (same seed = same quiz)
`paper`	select (a4, letter, a3)	"a4"	Paper for the sheet

Example request

Ten European capitals

curl -X POST https://cartographcountryquiz.usefulweb.site/api/v1/calculate -H 'content-type: application/json' -d '{"kind":"capital","region":"europe","count":10,"seed":"europe"}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://cartographcountryquiz.usefulweb.site/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: cartograph_country_quiz
Local stdio connector: node src/mcp-stdio.ts --tool=cartograph-country-quiz

{
  "mcpServers": {
    "cartograph-country-quiz": { "type": "http", "url": "https://cartographcountryquiz.usefulweb.site/mcp" }
  }
}