MCP Server

Use BrandMappr directly from Claude Desktop, Claude Code, or any MCP-compatible AI assistant. The MCP server exposes two tools for location data and map rendering.

Available tools

get_brand_locations

Returns all locations for a brand as JSON with name, address, lat/lng, phone, and hours. Accepts optional country, state, and city filters.

generate_brand_map

Generates a PNG map image of all brand locations. Supports Focus Mode via focus_country and focus_region parameters, all map styles, and custom marker colors.

Installation

npx @brandmappr/mcp-server

Source: github.com/brandmappr/brandmap-mcp-server (opens in a new tab) | npm (opens in a new tab)

Client Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "brandmap": {
      "command": "npx",
      "args": ["-y", "@brandmappr/mcp-server"],
      "env": {
        "BRANDMAP_API_KEY": "bm_live_your_api_key_here"
      }
    }
  }
}

Example prompts

Once configured, you can ask Claude things like:

"Show me all Starbucks locations in California"
"Generate a map of McDonald's locations in the US"
"How many Target stores are in Texas?"
"Create a dark-themed map of Walmart focused on the continental US"

Claude will call the appropriate MCP tool and return the data or rendered map image.

Code Examples Machine-Readable Docs