Skip to content
MCP server

roadstyle

Draw styled, interactive road maps of any place or road file, with PNG previews

Runs locally
Install
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.29.0
Listing updated
5 days ago

Similar MCP servers

About roadstyle

roadstyle is an MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

Rather than returning raw geodata, each tool call writes a self-contained HTML map to ~/roadstyle-maps/ and hands back its path plus a PNG preview the agent can inspect. The maps use road cartography with casing, zoom-dependent widths, street names, one-way arrows and tunnels and bridges drawn in the right order.

There are three tools: one downloads a place's OpenStreetMap roads through osmnx for drive, walk, bike or other network types, one draws a road file such as GeoPackage, GeoJSON or Shapefile, and one snapshots a saved map at a chosen position, zoom, bearing and pitch. Side streets only show names from zoom 17, which the docs suggest using when checking labels. An options argument accepts any render_edges keyword, for example colouring by maxspeed with a legend, and a misspelt keyword returns an error naming the closest valid one.

The PNG preview needs Chromium installed once through Playwright. An optional CARTO key changes the basemap; without it the keyless esri_street base is used. The same project is also a Python library with an agent skill file.

Install

Run in a terminal

claude mcp add roadstyle --env CARTO_API_KEY='<CARTO_API_KEY>' -- uvx roadstyle-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "roadstyle": {
      "command": "uvx",
      "args": [
        "roadstyle-mcp"
      ],
      "env": {
        "CARTO_API_KEY": "<CARTO_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "roadstyle": {
      "command": "uvx",
      "args": [
        "roadstyle-mcp"
      ],
      "env": {
        "CARTO_API_KEY": "<CARTO_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "roadstyle": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "roadstyle-mcp"
      ],
      "env": {
        "CARTO_API_KEY": "<CARTO_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "roadstyle": {
      "command": "uvx",
      "args": [
        "roadstyle-mcp"
      ],
      "env": {
        "CARTO_API_KEY": "<CARTO_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "roadstyle": {
      "command": "uvx",
      "args": [
        "roadstyle-mcp"
      ],
      "env": {
        "CARTO_API_KEY": "<CARTO_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CARTO_API_KEYCARTO basemap key; without it maps use the keyless esri_street base map

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

render_place
Downloads the OpenStreetMap roads of a place and draws them as an HTML map.
render_file
Draws a road file such as GeoPackage, GeoJSON or Shapefile.
snapshot
Makes a PNG of a saved map at a given position, zoom, bearing and pitch.

What it does

Place maps
Downloads OpenStreetMap roads for a named place and renders them.
Road file maps
Draws GeoPackage, GeoJSON, Shapefile and similar files.
PNG snapshots
Captures a saved map at a given location, zoom, bearing and pitch.
Colour by data
Options colour roads by a column such as maxspeed, with a legend.
Offline HTML output
Each map is one file that opens without a server.
Agent skill
A one-page skill teaches code-writing agents the library.

Good for

  • Map the drivable roads of a city and colour them by speed limit
  • Check street names and one-way arrows on a rendered network
  • Visualise a road dataset from a GeoPackage
  • Generate a shareable offline road map
  • Produce a preview image for a report

roadstyle FAQ

Where are maps saved?

In ~/roadstyle-maps/, and the tool returns the path.

What do I need for previews?

Chromium, installed once with uvx --from roadstyle-mcp playwright install chromium.

Do I need a basemap key?

No. Without a CARTO key, the keyless esri_street base map is used.

How do I add it to Claude Code?

Run claude mcp add roadstyle -- uvx roadstyle-mcp.

How do I add roadstyle to Claude Code?

Run this command in your terminal: claude mcp add roadstyle --env CARTO_API_KEY='<CARTO_API_KEY>' -- uvx roadstyle-mcp

What are the best alternatives to roadstyle?

The closest alternatives to roadstyle are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers