MCP Server

Use BrandMappr directly from Claude Desktop, Claude Code, or any MCP-compatible AI assistant. The MCP server (v1.2.0) exposes four tools organized around the actual product model — image-first for everyone, with data as a premium tier.

Available tools

render_brand_map (primary)

PNG/JPEG map image. Works on every key tier (trial, credits, metered, enterprise, unlimited). Use this for any "show me / make a map of" request.

Supports the full current render surface — country/state/city/postcode/radius/bounds filters, all 6 style themes, marker colors (single + multi-company via tickers), legend, heatmap, explicit zoom / center / padding framing, and Focus Map (focus_country accepts an ISO code OR "auto" to render every country the brand has locations in; conus for US lower-48 only; mainland_only to crop any country with overseas territories to its populated mainland — FR, DK, GB, NO, JP, ID, PH, IT, GR, NZ, SE; regions for state/province outlines; 5-option projection selector: albers, miller, mercator, robinson, natural_earth1).

get_brand_summary (public, no key)

Whether a brand is in the dataset, location count, last-updated, 5-row sample. No API key required. Use to check coverage before requesting a paid render.

quote_brand_export (public, no key)

Price + sample preview for a one-time ad-hoc CSV purchase. No API key required. Use to show a buyer what they'd get and what it'd cost before they commit. The actual purchase happens on brandmappr.com (Stripe Checkout); this tool is the pre-purchase quote only.

get_brand_locations (enterprise / unlimited only)

Raw location data (JSON / CSV / GeoJSON). Standard keys (credits / metered / trial) get 403 DATA_ACCESS_FORBIDDEN — data access is restricted to enterprise contracts and the unlimited admin/internal model. For everyone else, use render_brand_map (any tier) or quote_brand_export → checkout on brandmappr.com.

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:

"Generate a map of every country Starbucks operates in" → render_brand_map with focus_country: "auto"
"Make a map of Walmart locations in California with dark style" → render_brand_map
"Compare Starbucks and McDonald's locations across the US with a legend" → render_brand_map with tickers: ["SBUX","MCD"]
"How many Subway stores does BrandMappr have data for?" → get_brand_summary
"What would a CSV of all Chick-fil-A locations cost?" → quote_brand_export
"Show me Starbucks in the UK with the Robinson projection" → render_brand_map with projection: "robinson"

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

Code Examples Machine-Readable Docs