Skip to content
MCP server

Balad Maps

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.1
Listing updated
5 days ago

About Balad Maps

Balad Maps is an open-source MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "balad-mcp": {
      "command": "uvx",
      "args": [
        "balad-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "balad-mcp": {
      "command": "uvx",
      "args": [
        "balad-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • BALAD_MCP_PROXYOptional 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.

Pricing

Open source

Balad Maps FAQ

Is Balad Maps free?

Yes. Balad Maps is open source, so you can use and self-host it for free.

How do I add Balad Maps to Claude Code?

Run this command in your terminal: claude mcp add balad-mcp -- uvx balad-mcp

What are the best alternatives to Balad Maps?

The closest alternatives to Balad Maps are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

Alternatives to Balad Maps

  1. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  2. Curated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang

    • 9 tools
    • Remote
    • Free
    • Maps and travel
  3. Fifty Asks

    MCP server

    Let an agent book a free AI-visibility check or a 15-minute call for a local business

    • 10 tools
    • Remote
    • Free
    • Maps and travel
  4. Gangway AIS

    MCP server

    Vessel positions, port calls and anchorage waiting times from licensed AIS data

    • 21 tools
    • Remote
    • Freemium
    • Freight and logistics
  5. Goyondo

    MCP server

    Agent-native trip planner where your AI builds the itinerary and Goyondo stores it

    • Remote
    • Freemium
    • Maps and travel