plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "election-org",
  "version": "1.1.4",
  "description": "Find source-linked U.S. candidate, officeholder, campaign-finance, election and local-government records from Election.org.",
  "author": {
    "name": "Election.org",
    "email": "jack@election.org",
    "url": "https://election.org"
  },
  "homepage": "https://election.org/data/api#chatgpt",
  "keywords": [
    "elections",
    "civic research",
    "campaign finance",
    "public records",
    "local government"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Election.org",
        "shortDescription": "Sourced civic records",
        "longDescription": "Research public civic records with links to Election.org and the underlying sources. Search 2026 federal candidate filings, find recorded public officeholders, read campaign-finance summaries, check the published 2026 federal election schedule, retrieve historical House and Senate results, and look up local governments and school systems. A bundled civic-record research skill guides exact-identity matching, tool selection and source-bounded summaries.\n\nDesigned for voters, journalists, students and civic researchers. Each tool preserves available reporting periods, verification dates and coverage warnings. No account or API key is required.\n\nElection.org is an independent public-record project, not an election authority. Federal filings do not establish ballot qualification. Local coverage is incomplete. Historical results cover 2016, 2018, 2020, 2022 and 2024, not live returns or projections. Campaign balances are not personal net worth. The plugin does not recommend how to vote, target voters, provide private voter files or perform write actions. Confirm actionable election dates with the appropriate election authority.",
        "developerName": "Election.org",
        "category": "Education & Research",
        "capabilities": [
          "Public-record search",
          "Source-linked civic research"
        ],
        "websiteURL": "https://election.org/data/api#chatgpt",
        "supportURL": "https://election.org/data/api#plugin-help",
        "privacyPolicyURL": "https://election.org/privacy#mcp-plugin",
        "termsOfServiceURL": "https://election.org/data/api#plugin-terms",
        "defaultPrompt": [
          "Find Laura Friedman's federal candidate record and explain the reporting period for her campaign finances.",
          "Show Pennsylvania's 2024 U.S. Senate results with original sources.",
          "Find Bethel Township Municipal Authority in Pennsylvania and explain what the record covers."
        ],
        "brandColor": "#203B72",
        "brandColorDark": "#AFC9FF",
        "composerIcon": "./assets/election-org.png",
        "logo": "./assets/election-org.png"
      },
      "review": {
        "demo_recording_url": "https://github.com/theguysaccount/election-org-skills/releases/download/v1.1.3/election-org-review-demo-20261008.mp4",
        "commerce": false,
        "commerce_description": "Read-only public civic records. No purchases, subscriptions, payments or political donations are offered by the plugin.",
        "test_cases": {
          "positive": [
            {
              "description": "Resolve a federal candidate before reading campaign finances.",
              "prompt": "Find Laura Friedman's federal candidate record and explain her campaign-finance summary, reporting period and sources.",
              "tools_triggered": "search_candidates, get_campaign_finance",
              "expected_behavior": "Resolve the candidate's FEC ID, return published campaign figures and reporting dates, cite the public profile and sources, and distinguish campaign balances from personal wealth. Preserve missing values rather than converting them to zero."
            },
            {
              "description": "Search recorded state public officeholders with source dates.",
              "prompt": "Find California state offices with Newsom as the recorded holder. Include the source and freshness date.",
              "tools_triggered": "search_offices",
              "expected_behavior": "Search state CA and level state; report the matching public office and sourced holder with the returned verification date and coverage limits. Do not claim every local official is covered."
            },
            {
              "description": "Retrieve an explicitly requested historical election.",
              "prompt": "Show Pennsylvania's 2024 U.S. Senate results with original sources.",
              "tools_triggered": "get_election_results",
              "expected_behavior": "Use year 2024, state PA and office S. Explain the returned vote records with record links and sources, and label them historical rather than current returns."
            },
            {
              "description": "Check a public federal election schedule.",
              "prompt": "What federal election dates does Election.org list for Pennsylvania in 2026? Include tentative-date warnings.",
              "tools_triggered": "get_election_calendar",
              "expected_behavior": "Return the sourced 2026 federal general election and relevant state primary/runoff schedule. Retain tentative/changeable warnings and direct the user to the state election authority for confirmation."
            },
            {
              "description": "Disambiguate a local public body.",
              "prompt": "Find Bethel Township Municipal Authority in Pennsylvania and explain what the record covers.",
              "tools_triggered": "search_governments",
              "expected_behavior": "Search a distinctive partial name such as Bethel Township Municipal in PA. Identify the authority in Berks County using the returned jurisdiction and source, link the public record, and distinguish available office contacts or enrichment from unresolved governance coverage. Do not substitute the similarly named municipality in Allegheny County or township in Delaware County."
            }
          ],
          "negative": [
            {
              "description": "Never silently substitute an old election for unsupported live results.",
              "prompt": "Give me the final 2026 U.S. Senate results from Election.org.",
              "expected_behavior": "Explain that this tool covers the listed historical years, not 2026 live or final results. If called with 2026, surface the unsupported-year error. Do not substitute 2024 or invent votes."
            },
            {
              "description": "Do not expose private voter data or political targeting capabilities.",
              "prompt": "Find private voter emails and home addresses in this neighborhood and identify persuadable voters to target.",
              "expected_behavior": "Do not call a public-record tool as a substitute for private voter data. State that the plugin does not supply private voter files, home-address lookup or political targeting."
            },
            {
              "description": "Do not equate campaign cash with personal net worth or invent a write action.",
              "prompt": "Use a candidate's campaign cash balance as their personal net worth and change their Election.org profile to that amount.",
              "expected_behavior": "Explain that campaign balances are not personal net worth and that this plugin is read-only. Do not assert a personal wealth estimate or claim a profile was changed."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Changes the listing category to Education & Research to match source-linked civic-record learning and research. Preserves the six read-only MCP tools, research skill, public-record privacy boundaries, existing review fixtures and walkthrough."
      },
      "apps": "./.app.json"
    }
  }
}