.codex-plugin/plugin.json

{
  "name": "census-geocode",
  "version": "1.0.0",
  "description": "US address lists to geography",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://census-geocode.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "census tract lookup",
    "address to lat long",
    "geocode addresses",
    "batch geocoding",
    "congressional district by address",
    "census tract by address",
    "geocode a list of addresses",
    "convert addresses to latitude and longitude",
    "state legislative district by address",
    "block group lookup"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Zovo Address Geocoder",
    "shortDescription": "US address lists to geography",
    "longDescription": "Geocode a list of US business addresses to latitude and longitude, county, census tract and block group, with congressional and state legislative districts, in an Excel file.\n\nPaste one address per line or CSV text with an Address or Street header. The downloadable XLSX and CSV files include the input rows and columns, with match status, matched address, coordinates, county and FIPS, tract, block group and block GEOIDs appended. XLSX cells are capped at Excel's 32,767-character limit; the CSV keeps input values in full. District lookup adds congressional and state legislative districts, school districts and places. Filter, search and sort the address preview, copy coordinates, and download the results.\n\nSupports nonprofit grant applications and address-list operations. Up to 1,000 addresses for coordinates and tracts, or 100 with districts, with a 200,000-character input limit. A 1,000-row list may take about 30 seconds, or longer when the service is slow.\n\nCoverage: US address ranges in the 50 states, DC, Puerto Rico and covered island areas. Coordinates are interpolated street points and may be tens of meters from a building. PO boxes, rural routes and new streets may not match. Check changed matches. Districts use current boundary files, including the 120th Congress and 2026 state legislative districts as of October 21, 2026; they do not identify elected representatives. Service errors appear by row and successful chunks remain available. Generated files are kept for one hour for their download links.",
    "developerName": "Zovo",
    "category": "Business & Operations",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://census-geocode.zovo.one",
    "supportURL": "https://census-geocode.zovo.one/support",
    "privacyPolicyURL": "https://census-geocode.zovo.one/privacy",
    "termsOfServiceURL": "https://census-geocode.zovo.one/terms",
    "defaultPrompt": [
      "Geocode these addresses: 1600 Pennsylvania Ave NW, Washington, DC 20500 and 1437 Bannock St, Denver, CO 80202",
      "Census tract lookup for 350 Fifth Ave, New York, NY 10118",
      "Congressional district by address: 1445 K St, Lincoln, NE 68508, with state legislative districts"
    ],
    "brandColor": "#256d60",
    "brandColorDark": "#88d2b9",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/census-geocode/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Address list to coordinates",
              "prompt": "Geocode these addresses, one per line: 1600 Pennsylvania Ave NW, Washington, DC 20500; 1437 Bannock St, Denver, CO 80202",
              "tools_triggered": "geocode_addresses",
              "expected_behavior": "Returns address match counts, geography preview, Excel and CSV downloads, and a source retrieval line. Original columns are preserved in the generated files."
            },
            {
              "description": "District columns",
              "prompt": "Congressional district by address: 1437 Bannock St, Denver, CO 80202",
              "tools_triggered": "find_address_districts",
              "expected_behavior": "Returns address match counts, geography preview, Excel and CSV downloads, and a source retrieval line. Original columns are preserved in the generated files."
            },
            {
              "description": "Preserve CSV columns",
              "prompt": "Geocode this CSV:\nAddress,City,State,ZIP,Member name\n350 Fifth Ave,New York,NY,10118,Sample member",
              "tools_triggered": "geocode_addresses",
              "expected_behavior": "Returns address match counts, geography preview, Excel and CSV downloads, and a source retrieval line. Original columns are preserved in the generated files."
            },
            {
              "description": "Unicameral state",
              "prompt": "State legislative district by address: 1445 K St, Lincoln, NE 68508",
              "tools_triggered": "find_address_districts",
              "expected_behavior": "Returns address match counts, geography preview, Excel and CSV downloads, and a source retrieval line. Original columns are preserved in the generated files."
            },
            {
              "description": "Tract lookup",
              "prompt": "Census tract lookup for 400 Broad St, Seattle, WA 98109",
              "tools_triggered": "geocode_addresses",
              "expected_behavior": "Returns address match counts, geography preview, Excel and CSV downloads, and a source retrieval line. Original columns are preserved in the generated files."
            }
          ],
          "negative": [
            {
              "description": "Representative contact details are outside scope; do not call the tools.",
              "prompt": "Who is my representative and how do I contact them?"
            },
            {
              "description": "Canadian addresses are outside coverage; do not call the tools.",
              "prompt": "Geocode 100 Queen St W, Toronto, Canada."
            },
            {
              "description": "Driving directions are outside scope; do not call the tools.",
              "prompt": "Driving directions from Denver to Boulder."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://census-geocode.zovo.one/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial address geocoding and district lookup with XLSX and CSV downloads.",
        "translations": {
          "pl-PL": {
            "subtitle": "Geografia adres\u00f3w w USA",
            "description": "Geokoduj list\u0119 adres\u00f3w w USA do wsp\u00f3\u0142rz\u0119dnych, hrabstw, obwod\u00f3w i okr\u0119g\u00f3w. Pobierz XLSX i CSV z zachowaniem kolumn. Limit: 1000 adres\u00f3w lub 100 z okr\u0119gami. Pliki wygasaj\u0105 po godzinie."
          },
          "de-DE": {
            "subtitle": "US-Adressen geokodieren",
            "description": "US-Adresslisten in Koordinaten, Countys, Z\u00e4hlbezirke und Wahlbezirke umwandeln. XLSX und CSV behalten die Eingabespalten. Bis zu 1000 Adressen oder 100 mit Wahlbezirken. Dateien bleiben eine Stunde verf\u00fcgbar."
          },
          "es-ES": {
            "subtitle": "Geograf\u00eda de direcciones US",
            "description": "Convierte direcciones de EE. UU. en coordenadas, condados, zonas censales y distritos. Descarga XLSX y CSV conservando las columnas. Hasta 1000 direcciones o 100 con distritos. Archivos disponibles durante una hora."
          },
          "fr-FR": {
            "subtitle": "G\u00e9ocoder des adresses US",
            "description": "Convertissez des adresses am\u00e9ricaines en coordonn\u00e9es, comt\u00e9s, secteurs de recensement et circonscriptions. XLSX et CSV conservent les colonnes. Limite de 1000 adresses ou 100 avec circonscriptions. Fichiers disponibles une heure."
          },
          "ja-JP": {
            "subtitle": "\u7c73\u56fd\u4f4f\u6240\u306e\u5730\u7406\u60c5\u5831",
            "description": "\u7c73\u56fd\u306e\u4f4f\u6240\u4e00\u89a7\u304b\u3089\u5ea7\u6a19\u3001\u90e1\u3001\u56fd\u52e2\u8abf\u67fb\u533a\u3001\u9078\u6319\u533a\u3092\u691c\u7d22\u3057\u307e\u3059\u3002\u5143\u306e\u5217\u3092\u4fdd\u6301\u3057\u305fXLSX\u3068CSV\u3092\u30c0\u30a6\u30f3\u30ed\u30fc\u30c9\u3067\u304d\u307e\u3059\u3002\u4e0a\u9650\u306f1000\u4ef6\u3001\u9078\u6319\u533a\u4ed8\u304d\u306f100\u4ef6\u3067\u3059\u3002\u30d5\u30a1\u30a4\u30eb\u306f1\u6642\u9593\u4fdd\u5b58\u3055\u308c\u307e\u3059\u3002"
          },
          "pt-BR": {
            "subtitle": "Geografia de endere\u00e7os dos EUA",
            "description": "Converta endere\u00e7os dos EUA em coordenadas, condados, setores censit\u00e1rios e distritos. Baixe XLSX e CSV preservando as colunas. At\u00e9 1000 endere\u00e7os ou 100 com distritos. Arquivos dispon\u00edveis por uma hora."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}