Agents menu
Get started
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
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
- PluginBundles the MCP server and the
create-mapskill in one install. The best choice where your client has plugins: Claude Code, Codex, Cursor, Gemini CLI. - MCP serverPoint any MCP client at
https://maps.polygrid.dev/mcp. One URL, no auth. Works everywhere, including claude.ai and VS Code. - 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
- Claude CodePlugin or one MCP command.
- CodexPlugin or
config.toml. - CursorPlugin or one-click MCP install.
- Claude.ai and DesktopCustom connector or skill upload.
- Gemini CLIOne extension install.
- VS Code and CopilotMCP server with inline maps.
- Other clientsWindsurf, Zed, Cline, OpenCode, any MCP JSON.
- Skill onlyJust the create-map skill, via
npx skills.
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-updateOn 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.