Balad Maps MCP Server

by sepehr071 Your server? Claim it

local only

Balad Maps runs on your own machine — the client starts it, so there is no endpoint to ping. 410 installs a week from pypi. Last commit 31 Oct 2026.

Read-only Balad (balad.ir) Iran map: places nearby or on the way, details, reviews, driving routes.

Installs per day peak 343 · avg 13

a month agotoday

410

Installs / week

pypi · balad-mcp

Stars

0 open issues

31 Oct 2026

Last commit

from GitHub

MIT

License

Python

Nothing serious here today

Today is the operative word: we check Balad Maps every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add balad-mcp -- uvx balad-mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "balad-mcp": {
      "command": "uvx",
      "args": [
        "balad-mcp"
      ]
    }
  }
}

~/.codex/config.toml

[mcp_servers.balad-mcp]
command = "uvx"
args = ["balad-mcp"]

.cursor/mcp.json

{
  "mcpServers": {
    "balad-mcp": {
      "command": "uvx",
      "args": [
        "balad-mcp"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "balad-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "balad-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: BALAD_MCP_PROXY (Optional HTTP proxy URL for the Balad requests; system proxy settings are ignored. Also accepts a comma-separated list: one is used until it gets blocked or fails to connect, then the next).

Alternatives to Balad Maps

same job, measured the same way

Neshan Maps

by sepehr071

Read-only Neshan map of Iran: places, reviews, photos, routes, travel times, zones, air quality.

378 installs/wk local only

INAVI Maps API

by inavi-systems

INAVI Maps API for AI (South Korea): place search, geocoding, routes on an interactive map

516 installs/wk local only

squidmaps

by squidmaps

Make a web map of places, routes and areas, and get a link to share it.

4 tools answering

Streetmap Port

by cloudcorprecords

Geocode, reverse geocode and find nearby places with the public OpenStreetMap APIs.

local only

Amtrak MCP

by mrfentmen

Amtrak realtime: every train on the map with delay, speed and next stop, plus route and station.

307 installs/wk local only

Tripadvisor MCP

by chrischall

TripAdvisor location search, details, photos, and reviews via the Terra API

502 installs/wk local only

Registry Expansion Routing

by bonissystems

Public-registry routing map by entity kind. Read-only reference data, not a determination.

1 tools answering

Maps by DeltaBreen

by deltabreen

Put a map on a site with your AI: map your places, design the look, and get the code.

answering

Balad Maps — questions

Answers built from our own checks of this server.

Why is there no uptime for Balad Maps?

Balad Maps runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package balad-mcp was installed 410 times last week.

How do I connect Balad Maps?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls balad-mcp straight from pypi; nothing to host, nothing to sign up for.

How many people use Balad Maps?

The pypi package balad-mcp was installed 410 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Balad Maps open source?

Yes — it is published under the MIT licence, written in Python and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.