tn-elections-mcp 0.5.0

package/dist/types.d.ts

@@ -0,0 +1,270 @@
+/** Auth context returned by bootstrap endpoint */
+export interface EasyVoteAuthContext {
+    UserId: string;
+    CustomerId: string;
+    ZumoToken: null;
+}
+/** Filer document from documentsearch endpoint */
+export interface EasyVoteDocument {
+    documentnameid: [string, string] | null;
+    documentid: string;
+    documentname: string;
+    datesubmitted: string;
+    documenttype: string;
+    electionname: string | null;
+}
+/** Filer from documentsearch endpoint */
+export interface EasyVoteFiler {
+    filerid: string;
+    firstname: string;
+    middlename: string | null;
+    lastname: string;
+    committeename: string;
+    filertype: string;
+    status: string;
+    displayname: string;
+    officename: string;
+    imgurl: string | null;
+    documents: EasyVoteDocument[];
+}
+/** Office from offices endpoint */
+export interface EasyVoteOffice {
+    guid: string;
+    name: string;
+}
+/** Contribution record from advancedsearch endpoint (34 fields) */
+export interface EasyVoteContribution {
+    DocumentFilingId: string;
+    DocumentId: string | null;
+    DocumentType: string;
+    ItemizedListType: string;
+    RecipientFirstName: string;
+    RecipientMiddleInitial: string | null;
+    RecipientLastName: string;
+    RecipientCommitteeName: string;
+    OfficeGuid: string;
+    OfficeName: string;
+    ContributorFullName: string | null;
+    ContributorFirstName: string;
+    ContributorMiddleName: string | null;
+    ContributorLastName: string;
+    ContributorOrganizationName: string | null;
+    ContributorAddress: string;
+    ContributorCity: string;
+    ContributorState: string;
+    ContributorZip: string;
+    ContributionDate: string;
+    ContributionAmount: number;
+    ContributionDateDate: string;
+    CustomSearchResultFields: unknown | null;
+}
+/** Distribution/expenditure record from advancedsearch/distributions endpoint */
+export interface EasyVoteDistribution {
+    DocumentFilingId: string;
+    DocumentType: string;
+    ItemizedListType: string;
+    CandidateFirstName: string;
+    CandidateMiddleInitial: string | null;
+    CandidateLastName: string;
+    CandidateCommitteeName: string;
+    OfficeGuid: string;
+    OfficeName: string;
+    PayeeFirstName: string | null;
+    PayeeLastName: string;
+    PayeeOrganizationName: string | null;
+    PayeeAddress: string;
+    PayeeCity: string;
+    PayeeState: string;
+    PayeeZip: string;
+    DistributionDate: string | null;
+    DistributionAmount: number;
+    DistributionDateDate: string | null;
+    CustomSearchResultFields: unknown | null;
+}
+/** Office from cpsearch form dropdown */
+export interface TncampOffice {
+    id: string;
+    name: string;
+}
+/** District from districts.htm JSON endpoint */
+export interface TncampDistrict {
+    id: string;
+    label: string;
+    officeId: string;
+}
+/** Election year from cpsearch form dropdown */
+export interface TncampElectionYear {
+    id: string;
+    label: string;
+}
+/** Parsed dropdowns from cpsearch.htm form page */
+export interface TncampFormOptions {
+    offices: TncampOffice[];
+    electionYears: TncampElectionYear[];
+    parties: {
+        id: string;
+        name: string;
+    }[];
+}
+/** Candidate/PAC from cpsearch results */
+export interface TncampCandidate {
+    name: string;
+    party: string;
+    officeSought: string;
+    district: string;
+    electionYear: string;
+    candidateId: number;
+    reportListUrl: string;
+}
+/** Report entry from replist.htm */
+export interface TncampReport {
+    election: string;
+    reportName: string;
+    isAmendment: boolean;
+    submittedOn: string;
+    reportId: number;
+    reportUrl: string;
+}
+/** Line item in a report's itemized section (receipts, disbursements, loans) */
+export interface TncampLineItem {
+    name: string;
+    address: string;
+    date: string;
+    amount: number;
+    employer?: string;
+    occupation?: string;
+    purpose?: string;
+}
+/** Full parsed report from report_full.htm */
+export interface TncampReportDetail {
+    reportId: number;
+    candidateName: string;
+    reportTitle: string;
+    beginningBalance: number;
+    totalContributions: number;
+    totalReceipts: number;
+    totalExpenditures: number;
+    totalDisbursements: number;
+    endingBalance: number;
+    totalOutstandingLoans: number;
+    receipts: TncampLineItem[];
+    disbursements: TncampLineItem[];
+    inKindContributions: TncampLineItem[];
+    loans: TncampLineItem[];
+    obligations: TncampLineItem[];
+}
+/** Contribution from cesearch results */
+export interface TncampContribution {
+    type: string;
+    amount: number;
+    date: string;
+    electionYear: string;
+    recipientName: string;
+    contributorName: string;
+    contributorAddress: string;
+    contributorOccupation: string;
+    contributorEmployer: string;
+}
+/** Expenditure from cesearch results */
+export interface TncampExpenditure {
+    type: string;
+    amount: number;
+    date: string;
+    vendorName: string;
+    vendorAddress: string;
+    purpose: string;
+    candidateFor: string;
+}
+/** Pagination metadata from DisplayTag results pages */
+export interface TncampPaginationInfo {
+    totalItems: number;
+    currentPage: number;
+    totalPages: number;
+    itemsPerPage: number;
+    paginationParam: string;
+}
+export interface SumnerElectionCycle {
+    year: string;
+    url: string;
+    label: string;
+}
+export interface SumnerOffice {
+    name: string;
+    district?: string;
+    isMunicipal: boolean;
+    municipality?: string;
+}
+export interface SumnerReportLink {
+    reportName: string;
+    pdfUrl: string;
+}
+export interface SumnerCandidate {
+    name: string;
+    office: SumnerOffice;
+    reports: SumnerReportLink[];
+    cycle: string;
+}
+export interface SumnerNonDisclosure {
+    name: string;
+    cycle: string;
+}
+export interface SumnerCyclePage {
+    cycle: SumnerElectionCycle;
+    candidates: SumnerCandidate[];
+    nonDisclosures: SumnerNonDisclosure[];
+    scrapedAt: string;
+}
+export interface SumnerContribution {
+    date: string;
+    name: string;
+    address: string;
+    amount: number;
+    type: string;
+    employer?: string;
+    occupation?: string;
+}
+export interface SumnerExpenditure {
+    date: string;
+    payee: string;
+    address: string;
+    amount: number;
+    purpose?: string;
+}
+export interface SumnerReportData {
+    candidateName: string;
+    officeSought: string;
+    reportPeriod: string;
+    beginningBalance: number;
+    totalContributions: number;
+    totalExpenditures: number;
+    endingBalance: number;
+    contributions: SumnerContribution[];
+    expenditures: SumnerExpenditure[];
+    extractionModel: string;
+    extractionConfidence: 'high' | 'medium' | 'low';
+    warnings: string[];
+}
+/** Official filed candidate from SOS Excel spreadsheet */
+export interface SosFiledCandidate {
+    office: string;
+    candidateName: string;
+    party: string;
+    city: string;
+    filingDate: string;
+    status: string;
+    officeCategory: string;
+}
+/** Office category from SOS candidate list page */
+export interface SosOfficeCategory {
+    name: string;
+    xlsxUrl: string;
+    pdfUrl: string;
+    candidateCount: number;
+}
+/** Full cached result from SOS page scrape + xlsx parsing */
+export interface SosCandidateIndex {
+    year: number;
+    offices: SosOfficeCategory[];
+    candidates: SosFiledCandidate[];
+    fetchedAt: number;
+}

package/dist/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// EasyVote Campaign Finance (county-level)
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2CAA2C;AAC3C,+DAA+D"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "tn-elections-mcp",
+  "version": "0.5.0",
+  "description": "MCP server for Tennessee elections: county campaign finance, state campaign finance, and financial disclosures",
+  "type": "module",
+  "bin": {
+    "tn-elections-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "tennessee",
+    "elections",
+    "campaign-finance",
+    "easyvote"
+  ],
+  "author": "Alex Reynolds",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/asreynolds1000/tn-elections-mcp.git"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "node-html-parser": "^7.0.2",
+    "xlsx": "^0.18.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsx": "^4.19.4",
+    "typescript": "^5",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}