plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "ultimaps-map-maker",
  "version": "1.0.0",
  "description": "Map your data on countries, states, counties and US ZIP code areas, with a legend, labels and pins.",
  "author": {
    "name": "Ultimaps",
    "email": "support@ultimaps.com",
    "url": "https://ultimaps.com"
  },
  "homepage": "https://ultimaps.com/mcp/",
  "keywords": [
    "maps",
    "map maker",
    "choropleth",
    "sales territories",
    "counties",
    "zip codes"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Ultimaps Map Maker",
        "shortDescription": "Map data on countries & states",
        "longDescription": "Ultimaps Map Maker turns your data into map images: choropleth, category and territory maps of countries, states, counties and US ZIP code areas. Describe the map and paste your figures or lists, and the map is shown in the conversation with a legend and a button to open it in Ultimaps Studio.\n\nWhat you can make:\n- Data maps: numbers per country, state or county become a choropleth, with color breaks computed from the data and, on request, values printed on the map.\n- Category maps: languages or religions by country, the countries you've visited, or passed, pending and no action, state by state.\n- Territory maps: a state's counties, or whole states, colored by sales rep, team or dealer, with the names in the legend.\n- Service-area maps: the counties you serve, split into core, extended and coming soon.\n- Footprint maps: countries or states where you have offices, customers or partners, with pins for locations.\n- Outline maps: a clean map of any country, state or county set with names, ready to color or print.\n\nEvery map comes with a title, a legend, optional region labels and pins, and one of 10 themes. Region names can be given as names or codes, and many typos are matched. Names that can't be matched are listed in the result.\n\nCoverage: 180+ base maps, from the world and every continent to the states and provinces of major countries, the counties of every US state, and US ZIP code areas (based on US Census ZCTAs). Borders come from published geographic boundary data, not drawn freehand.\n\nWho it is for: students, teachers, researchers, journalists and travelers; sales and operations teams, franchise and dealer networks; healthcare, nonprofit and public-sector organizations mapping their service areas; and anyone who needs a map for a slide deck, a report, a class or print.\n\nKeep going in Ultimaps Studio: recolor regions by hand, move labels, change the legend, export the map, or publish an interactive map with tooltips to share or embed on a website.\n\nLimitations:\n- Administrative regions only: countries, states, provinces, counties and US ZIP code areas. No street maps, routing, directions, satellite imagery or city neighborhoods.\n- Real places only; no custom or hand-drawn boundaries, and one base map per image.\n- Pins are placed by coordinates. ChatGPT can supply them for well-known places; street addresses are not looked up.\n- Images are PNG up to 1600 px wide, carry a small Ultimaps credit, and are rate-limited to about 30 per hour.\n- Each map's link can be opened by anyone who has it, so keep confidential figures out of maps you don't want shared.",
        "developerName": "Ultimaps",
        "category": "Data & Analytics",
        "capabilities": [
          "Render maps",
          "Find maps",
          "List map regions"
        ],
        "websiteURL": "https://ultimaps.com/mcp/#chatgpt",
        "supportURL": "https://ultimaps.com/mcp/#limits",
        "privacyPolicyURL": "https://ultimaps.com/privacy-policy/",
        "termsOfServiceURL": "https://ultimaps.com/terms/",
        "defaultPrompt": [
          "Color Ohio counties by sales rep: Lucas, Wood and Hancock are Maya; Cuyahoga, Summit and Stark are Sam. Label every county.",
          "Map population in millions: Brazil 212, Colombia 53, Argentina 46, Peru 34, Venezuela 28, Chile 20. Show values on the map.",
          "Color the countries I've visited: France, Italy, Japan, Peru, Mexico and Canada. Title it \"My travels\"."
        ],
        "brandColor": "#E8604C",
        "brandColorDark": "#E8604C",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Status map of US states",
              "prompt": "Map which states have passed our bill: Oregon and Maine passed; Ohio and Texas pending; the rest no action.",
              "tools_triggered": "render_map",
              "expected_behavior": "Renders a US states map with categories Passed and Pending in the legend; states without a category are reported or noted."
            },
            {
              "description": "Office pins on a US map",
              "prompt": "Pin our offices in Denver, Austin, Atlanta and Boston on a US map titled \"Where we work\".",
              "tools_triggered": "render_map",
              "expected_behavior": "Renders a US map with 4 labeled pins (coordinates supplied by the model) and the given title; no regions colored."
            },
            {
              "description": "Outline map with labels",
              "prompt": "A clean outline map of California counties with county names, no colors, for printing.",
              "tools_triggered": "render_map",
              "expected_behavior": "Renders the California counties map with every county labeled and no data colors."
            },
            {
              "description": "World choropleth from numbers",
              "prompt": "Map our 2025 customers by country: US 412, Germany 96, UK 88, Brazil 40, Japan 31.",
              "tools_triggered": "render_map",
              "expected_behavior": "Renders a world choropleth with a color scale and titled legend for the five countries."
            },
            {
              "description": "ZIP codes in one state",
              "prompt": "Highlight these ZIP codes on a map of Colorado: 80202, 80203, 80205, 80206, 80218.",
              "tools_triggered": "list_maps, render_map",
              "expected_behavior": "Finds the Colorado ZIP code map (list_maps, or directly) and renders it with the five ZIP code areas colored."
            }
          ],
          "negative": [
            {
              "description": "Distance and travel time",
              "prompt": "How far is Denver from Boulder by car, and how long does the drive take?"
            },
            {
              "description": "Fictional map",
              "prompt": "Draw a fantasy map of my D&D kingdom."
            },
            {
              "description": "Non-map chart",
              "prompt": "Make a bar chart of these quarterly sales figures."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin does not sell anything or take payments in ChatGPT."
      },
      "publication": {
        "release_notes": "First release: render_map, list_maps and get_map_regions, with an inline map viewer and an Edit in Ultimaps Studio button."
      },
      "apps": "./.app.json"
    }
  }
}