.codex-plugin/plugin.json

{
  "name": "geocode",
  "version": "0.5.3",
  "description": "Administrative boundaries and areas for any place on Earth: look up a country, state, county, city, district or postcode by name or point and get its polygon, list what is inside it, test points against it, merge several, or describe an area in plain language and get one validated polygon back.",
  "author": {
    "name": "Meter",
    "email": "jonathan@geocodeai.dev",
    "url": "https://meterapp.co"
  },
  "homepage": "https://geocodeai.dev/llms.txt",
  "repository": "https://github.com/MeterApp/geocode-plugins",
  "license": "MIT",
  "keywords": [
    "geocoding",
    "boundaries",
    "polygons",
    "geojson",
    "openstreetmap",
    "gis",
    "maps",
    "mcp"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Geocode AI",
    "shortDescription": "Boundaries and area polygons",
    "longDescription": "Look up any administrative boundary in the world by name or coordinate and get its polygon as GeoJSON; browse what is inside a boundary, check which zone each point falls in, merge several boundaries into one shape, or describe an area in plain language (even a clause from a contract) and get one validated polygon back.",
    "developerName": "Meter",
    "category": "Developer Tools",
    "capabilities": [
      "Read",
      "Write"
    ],
    "websiteURL": "https://geocodeai.dev",
    "defaultPrompt": [
      "Get the boundary of Alameda County as GeoJSON.",
      "Which city and county is 37.8, -122.27 in?",
      "Make one polygon for the Bay Area counties, excluding San Francisco."
    ],
    "brandColor": "#14857A",
    "composerIcon": "./assets/logo.svg",
    "logo": "./assets/logo.svg",
    "supportURL": "https://geocodeai.dev/docs",
    "privacyPolicyURL": "https://geocodeai.dev/privacy",
    "termsOfServiceURL": "https://geocodeai.dev/terms"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Find a boundary",
              "prompt": "Find Alameda County, California and show its boundary as GeoJSON.",
              "tools_triggered": "search_boundaries, get_boundary",
              "expected_behavior": "search_boundaries, then get_boundary using returned canonical ID. Preserve requested place and cite OpenStreetMap. Do not invent geometry."
            },
            {
              "description": "Reverse lookup",
              "prompt": "Which city and county contain latitude 37.8, longitude -122.27?",
              "tools_triggered": "reverse_boundaries",
              "expected_behavior": "reverse_boundaries with coordinate order confirmed from tool schema. Report actual matched boundaries."
            },
            {
              "description": "List children",
              "prompt": "List the counties within California.",
              "tools_triggered": "search_boundaries, list_children",
              "expected_behavior": "search_boundaries to resolve California, then list_children. Report pagination or incompleteness honestly."
            },
            {
              "description": "Containment",
              "prompt": "Check whether these two points are in Alameda County: 37.8,-122.27 and 34.05,-118.24.",
              "tools_triggered": "search_boundaries, contains_points",
              "expected_behavior": "Resolve boundary, then contains_points. Keep each point paired with returned containment result."
            },
            {
              "description": "Export",
              "prompt": "Export the boundary of Alameda County, California as KML.",
              "tools_triggered": "search_boundaries, export_boundary",
              "expected_behavior": "Resolve via search_boundaries, then export_boundary with format kml. Give returned download URL and provenance; requires entitled review account."
            }
          ],
          "negative": [
            {
              "description": "Wrong capability",
              "prompt": "What is the weather forecast in Alameda County tomorrow?",
              "expected_behavior": "Do not invoke Geocode AI: it provides boundary/area operations, not weather forecasts."
            },
            {
              "description": "Ambiguous location",
              "prompt": "Get the boundary of Springfield.",
              "expected_behavior": "Ask which Springfield or present candidates from search; do not silently choose one."
            },
            {
              "description": "Checkout restriction",
              "prompt": "Upgrade my Geocode AI account and send me the payment link.",
              "expected_behavior": "Do not initiate a subscription, produce checkout URLs, or promote an upgrade in this OpenAI plugin. Explain that purchases are unavailable here."
            }
          ]
        },
        "demo_recording_url": "https://geocodeai.dev/openai-review/api-walkthrough.mp4"
      },
      "publication": {
        "release_notes": "Initial OpenAI directory submission with existing-account workflows, OAuth connection, domain verification, and a restricted MCP profile. Subscription sales, upgrade offers, and credential-bearing setup are excluded. Dedicated reviewer accounts use isolated sample data. Direct authenticated MCP cases and server-denial checks are verified; model-level prompt handling is supplied as expected reviewer behavior."
      }
    }
  },
  "apps": "./.app.json"
}