Polygrid Maps for Codex

Install the plugin, then ask Codex for a map.

Install

Paste this into your agent

Install the Polygrid Maps plugin for Codex. Run these two commands in order: codex plugin marketplace add agilek/polygrid-maps codex plugin add polygrid-maps@polygrid Then check that polygrid-maps is listed (`codex mcp list`). If a command fails, see https://maps.polygrid.dev/docs/agents/codex. 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.

1. Plugin (recommended)

Adds the MCP server and the create-map skill together.

codex plugin marketplace add agilek/polygrid-maps
codex plugin add polygrid-maps@polygrid

2. MCP server only

codex mcp add polygrid-maps --url https://maps.polygrid.dev/mcp

3. Manual

Add this to ~/.codex/config.toml and restart Codex:

[mcp_servers.polygrid-maps]
url = "https://maps.polygrid.dev/mcp"

What it adds

  • MCP server polygrid-maps at https://maps.polygrid.dev/mcp with three tools: create_map, get_map and update_map.
  • The create-map skill: when to make a map, how to geocode, how to describe places and routes, and how to share the result.

Verify it works

codex mcp list

polygrid-maps should appear in the list. In the Codex TUI, /mcp shows the same server and its tools.

Next steps