AI Map

Describe the map you want in your own words. The AI Map operates GeoCanvas for you: it switches projections, adds and colours layers, and runs GIS analysis.

Describing a map to the AI Map and refining it step by step.

Getting started

On a wide screen the AI Map is a tab in the left panel, beside Projections. On a phone it is AI Map in the bar at the bottom. The welcome panel also has an Ask the AI section that opens the chat with an example already typed in.

Before the first message, tick the box to accept the privacy notice and press I understand, start the assistant. The confirmation is kept for 30 days. Your messages and a short description of the map (projection, zoom, layer names and what is selected) are sent to Mistral AI in France to produce the answer. The AI does not see the map image. GeoCanvas does not normally save your conversation. If you choose to submit a rating, the conversation is sent with your feedback and stored as explained in the privacy notice.

Read the privacy notice for the AI Map

How to ask

What it can do

A few examples for each area. Type them as they are or say the same in your own words, in any language.

Find and navigate

Locate places and features, zoom to layers, rotate and centre the map.

Centre the map on Japan.

Layers and data

Search the catalogue, add or remove layers, extract country borders, upload your own files.

Add the world’s rivers.

Colours, labels and legends

Paint layers or single features, classify by an attribute, label features, edit the legend.

Label the countries by name.

Projections and view

Switch and explain projections, set zoom and orientation, show the graticule and frame.

Switch to a projection that shows countries at their true size.

Selection

Select features by name or condition, measure them, make a layer from them.

Select Brazil and measure its area.

GIS analysis

Buffers, clipping, intersections, dissolving, spatial joins and more, each result as a new layer.

Draw a 50 km buffer around the rivers.

Export

Prepare an export with size and format set; you press Export to create the file.

Prepare a PNG at 3840 × 2160.

Help

Ask how something works in GeoCanvas or what the AI can do.

What can you do?

GIS analysis

The AI can process the vector layers on your map, much like the processing tools of a desktop GIS:

  • Geometry: buffer, centroids, convex hull, dissolve (all or by attribute), bounding box, simplify, smooth, split multipart shapes, extract vertices, points along lines, Voronoi and Delaunay, square or hexagonal grids.
  • Two layers: clip, intersection, difference and union.
  • Joins: by location (e.g. count the cities in each country, or sum their population) or by a matching attribute.
  • Selection into a new layer: by attribute value (“rivers longer than 1000 km”), by location (“cities within France”) or at random.
  • More: merge several layers into one, and check geometries for errors.

Every result is added as a new layer; the original layers are never changed. Undo with Ctrl+Z, or remove the layer in the Layers panel.

The analysis runs in your browser. Very large layers (more than about 5,000 features) are refused to keep the page responsive; filter them first. Distances are measured on the globe, in kilometres unless you say otherwise.

Allowance and subscription

Starting over

New chat clears the conversation. If the map has layers or changed tools, you choose: Keep map continues on the current map, Reset map removes all layers and restores the default view and tools (the projection stays). Ctrl+Z brings the layers back.

Connect your own AI client (MCP)

Besides the built-in AI Map, GeoCanvas has an MCP endpoint. An AI client you already use, such as Claude on the web, desktop or phone, Claude Code or Codex, can find data, build, colour, label and save GeoCanvas maps through it. This is part of GeoCanvas Creator, together with the larger AI allowance.

Open the account pageSee what GeoCanvas Creator includes

Server address

https://mcp.geocanvas.app/api/mcp

In Claude (web, desktop app, phone): add it as a connector

  1. In Claude, open Settings, then Connectors, and choose Add custom connector.
  2. Enter the server address shown above. Under Authentication choose Sign in now, under OAuth client Use Claude’s published identity, and leave the request headers empty.
  3. Sign in with your GeoCanvas account when Claude asks. It needs GeoCanvas Creator and a confirmed e-mail address, and you must have signed in on geocanvas.app once. No token is needed.

Claude then also offers ready-made GeoCanvas recipes in its prompt menu, such as a statistics map of countries or a map of the continents.

Other clients (Claude Code, Codex, editors): use an access token

  1. Subscribe to GeoCanvas Creator on your account page and confirm your e-mail address.
  2. On the account page, under Subscription, find Access tokens, create a token and copy it. It is shown only once.
  3. Add the server to your client with the address shown above and the token as a bearer header.

In every example, replace YOUR_TOKEN with your token.

Claude Code

Run this once in a terminal:

claude mcp add --transport http geocanvas https://mcp.geocanvas.app/api/mcp --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop

Claude Desktop reads its servers from claude_desktop_config.json (Settings, Developer, Edit Config). It needs Node.js for the small bridge program mcp-remote. Add this and restart the app:

{
  "mcpServers": {
    "geocanvas": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.geocanvas.app/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Codex

Add this to ~/.codex/config.toml, and set the environment variable GEOCANVAS_MCP_TOKEN to your token before you start Codex:

[mcp_servers.geocanvas]
url = "https://mcp.geocanvas.app/api/mcp"
bearer_token_env_var = "GEOCANVAS_MCP_TOKEN"

Any client that speaks MCP over Streamable HTTP and lets you set a request header works: give it the server address and the header Authorization: Bearer YOUR_TOKEN. Many editors use this form:

{
  "mcpServers": {
    "geocanvas": {
      "url": "https://mcp.geocanvas.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

ChatGPT and other apps that add servers by address are not supported yet.

What your client can do

  • Find data in the GeoCanvas catalogue, including its variants (such as 7 or 6 continents), statistics per country and your own uploads.
  • Colour layers by their data, with computed classes or the classes and labels a source publishes, and add labels and legends with a source line.
  • Draw its own points, lines, boxes and circles, and add the graticule, the tropics, time zones or a scale bar.
  • Analyse layers: buffers, clipping, joins and selections.
  • Save the finished map to My maps.

Working with it

Ask your client in plain words, for example:

Make a GeoCanvas map of Europe in an equal-area projection with rivers and lakes, and save it.

  • A map your client saves appears under My maps in your account and in the editor, private to you. The client can also use the datasets in My data.
  • One map is open per account at a time. A session ends after 15 minutes without a request and an unsaved map is then gone, so ask the client to save or export.
  • What you send through your client is also processed by that client and its provider, under their terms.
  • You can revoke a token on the account page at any time. Tokens work only while the subscription is active.

Good to know