Use Polygrid Maps from your AI agent

Ask for a map in plain words. Get a link.

Agents: when the user asks to change, add to or restyle a map you made in this conversation (add routes, add places, make it dark, rename), update that map in place with its edit token: same link, no new map. Create a new map only when they ask for a separate one. Multi-day or multi-leg routes go into one map with routes (route_view tabs), not one map per day. Keep the whole create response, not just the url: the edit token is returned only once, so save it (e.g. curl … -o map.json). If you lost it, ask for the private edit link instead of making a replacement map. Never show the raw edit token; give the private edit link only.

Polygrid Maps gives an AI agent a way to answer "show me on a map". It geocodes the places you name, draws routes or area data, and returns a public map link you can open, share or embed. No API key, no account.

Setup prompt

Not sure which route fits your agent? Paste this setup prompt and let it install Polygrid Maps itself.

Paste this into your agent

Set up Polygrid Maps so you can make shareable web maps for me. If you support plugins, install the Polygrid Maps plugin from https://github.com/agilek/polygrid-maps. Claude Code: `claude plugin marketplace add agilek/polygrid-maps` then `claude plugin install polygrid-maps@polygrid`. Codex: `codex plugin marketplace add agilek/polygrid-maps` then `codex plugin add polygrid-maps@polygrid`. Gemini CLI: `gemini extensions install https://github.com/agilek/polygrid-maps`. Otherwise add the MCP server https://maps.polygrid.dev/mcp (streamable HTTP, no auth) and install the create-map skill with `npx -y skills add agilek/polygrid-maps --skill create-map`. Full instructions: https://maps.polygrid.dev/docs/agents Then make a test map of three well-known places in my city and send me the link. Don't wait for a restart: the skill is already on disk, so read its skills/create-map/SKILL.md and run its scripts/publish.py directly. If this environment can't reach maps.polygrid.dev (sandbox, proxy or network allowlist), still make the map: publish.py then prints a publish link that opens the map in my own browser, ready to publish with one click. Send me that link. If you have no skill script, build that link yourself: https://maps.polygrid.dev/new#c= followed by the map request as JSON, base64url-encoded (details in https://maps.polygrid.dev/llms.txt). Then report back in two or three plain lines: that it is ready, the link, and one example of what I can ask next. Don't send me to add connectors, change network settings or ask an admin: a blocked network is handled by the publish link. Mention a restart only if it is really needed, as a short side note.

What an agent can do

  • Pin places from names and addresses, with categories, a filter legend, links and photos in popups.
  • Draw routes between stops in order, for trip itineraries.
  • Make data maps shaded by real numbers per district, region or country.
  • Change a map later on the same link, using the private edit token returned at creation.
  • Show the map inline in chat in hosts that support MCP Apps (claude.ai, Claude Desktop, VS Code).

Three ways to connect

  1. PluginBundles the MCP server and the create-map skill in one install. The best choice where your client has plugins: Claude Code, Codex, Cursor, Gemini CLI.
  2. MCP serverPoint any MCP client at https://maps.polygrid.dev/mcp. One URL, no auth. Works everywhere, including claude.ai and VS Code.
  3. Skill onlyTeach the agent the workflow and let it call the HTTP API itself. For agents without MCP, or sandboxes with web access.

Pick your client

Example prompts

Once Polygrid Maps is set up, ask for a map in plain words. Copy one and paste it into your agent.

  • Make a 3-day trip map of Lisbon: one color per day, the stops in order, and a route line for each day. Send me the link.
  • Make a map of the best specialty coffee places in Vienna, with a short note on each, so I can share it with friends.
  • Make a map of unemployment by district in Berlin, shaded by the latest figures, with a legend and the source named.

More example prompts: routes, places to share, data maps, and changing, embedding or exporting a map you already made.

Updates

The create-map skill keeps itself up to date: it checks the latest version once per conversation and updates itself when a newer one is out. To update by hand:

# Claude Code
claude plugin marketplace update polygrid
claude plugin update polygrid-maps@polygrid

# Codex
codex plugin marketplace upgrade polygrid
codex plugin add polygrid-maps@polygrid

# Gemini CLI
gemini extensions update polygrid-maps

# npx skills
npx -y skills update create-map

# any other copy, from the skill folder
python3 scripts/publish.py self-update

On claude.ai, download create-map.zip again and re-upload it. The latest version is at https://maps.polygrid.dev/v1/plugin; what changed is in the changelog.

Good to know

Travel modes. The agent uses the mode you state (drive, bike, walk, or metro/bus/train as transit). If you say nothing: walking within a city area with public transport for hops over about 2 km, car for road trips and lists of towns, never car by default inside a city. It says which mode it used in one line, and you can ask "switch it to driving": the same map and link are updated in place.

Maps are public by link, expire after 30 days without views, and the edit token is a secret that belongs to you. Read what the agent can and can't do before putting anything sensitive on a map.

Want to see a map first? Try the playground. Building your own integration? See the API docs, llms.txt and the OpenAPI schema.