@cyanheads/openfec-mcp-server 0.4.1 → 0.4.3

package/dist/mcp-server/resources/definitions/index.d.ts

@@ -7,10 +7,36 @@ export { committeeResource } from './committee.resource.js';
 export { electionDistrictResource, electionResource, electionStateResource, } from './election.resource.js';
 export declare const allResourceDefinitions: (import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
     candidate_id: import("zod").ZodString;
-}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
+}, import("zod/v4/core").$strip>, undefined, readonly [{
+    readonly reason: "candidate_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No candidate exists for the supplied candidate_id";
+    readonly recovery: "Verify the candidate_id format (H/S/P + digits) or look up the candidate by name via openfec_search_candidates.";
+}]> | import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
     committee_id: import("zod").ZodString;
-}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
+}, import("zod/v4/core").$strip>, undefined, readonly [{
+    readonly reason: "committee_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No committee exists for the supplied committee_id";
+    readonly recovery: "Verify the committee_id format (C + digits) or look up the committee by name via openfec_search_committees.";
+}]> | import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
     cycle: import("zod").ZodString;
-    office: import("zod").ZodString;
-}, import("zod/v4/core").$strip>, undefined>)[];
+    office: import("zod").ZodEnum<{
+        P: "P";
+    }>;
+}, import("zod/v4/core").$strip>, undefined, undefined> | import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
+    cycle: import("zod").ZodString;
+    office: import("zod").ZodEnum<{
+        H: "H";
+        S: "S";
+    }>;
+    state: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, undefined, undefined> | import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
+    cycle: import("zod").ZodString;
+    office: import("zod").ZodEnum<{
+        H: "H";
+    }>;
+    state: import("zod").ZodString;
+    district: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, undefined, undefined>)[];
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/definitions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAUhC,eAAO,MAAM,sBAAsB;;;;;;;+CAMlC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAUhC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0DAMlC,CAAC"}

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -19,13 +19,32 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     }>>;
     state: import("zod").ZodOptional<import("zod").ZodString>;
     office: import("zod").ZodOptional<import("zod").ZodEnum<{
+        P: "P";
         H: "H";
         S: "S";
-        P: "P";
     }>>;
     report_type: import("zod").ZodOptional<import("zod").ZodString>;
     report_year: import("zod").ZodOptional<import("zod").ZodNumber>;
-    category: import("zod").ZodOptional<import("zod").ZodString>;
+    category: import("zod").ZodOptional<import("zod").ZodEnum<{
+        20: "20";
+        21: "21";
+        22: "22";
+        23: "23";
+        24: "24";
+        25: "25";
+        26: "26";
+        27: "27";
+        28: "28";
+        29: "29";
+        32: "32";
+        33: "33";
+        34: "34";
+        36: "36";
+        37: "37";
+        38: "38";
+        39: "39";
+        40: "40";
+    }>>;
     election_year: import("zod").ZodOptional<import("zod").ZodNumber>;
     description: import("zod").ZodOptional<import("zod").ZodString>;
     min_date: import("zod").ZodOptional<import("zod").ZodString>;
@@ -41,15 +60,15 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
         per_page: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>;
     search_criteria: import("zod").ZodOptional<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
-}, import("zod/v4/core").$strip>> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     mode: import("zod").ZodDefault<import("zod").ZodEnum<{
         summary: "summary";
         search: "search";
     }>>;
     office: import("zod").ZodEnum<{
-        president: "president";
-        senate: "senate";
-        house: "house";
+        P: "P";
+        H: "H";
+        S: "S";
     }>;
     cycle: import("zod").ZodNumber;
     state: import("zod").ZodOptional<import("zod").ZodString>;
@@ -65,15 +84,35 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
         per_page: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>;
     search_criteria: import("zod").ZodOptional<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
-}, import("zod/v4/core").$strip>> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "cycle_must_be_even";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Cycle is an odd year";
+    readonly recovery: "Federal election cycles are two-year periods ending in even years (e.g., 2024, 2026).";
+}, {
+    readonly reason: "missing_state_for_office";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Senate or House office without a state and without a zip";
+    readonly recovery: "Provide a two-letter state code (e.g., AZ) or a zip code to scope the senate or house race.";
+}, {
+    readonly reason: "missing_district_for_house";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "House office without a district number and without a zip";
+    readonly recovery: "Provide a two-digit district number (e.g., \"07\") or a zip code to identify the House race.";
+}, {
+    readonly reason: "summary_does_not_support_zip";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Summary mode invoked with a zip parameter";
+    readonly recovery: "Use mode \"search\" for ZIP-based lookups, or remove zip and use state and district for summary mode.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     query: import("zod").ZodOptional<import("zod").ZodString>;
     candidate_id: import("zod").ZodOptional<import("zod").ZodString>;
     state: import("zod").ZodOptional<import("zod").ZodString>;
     district: import("zod").ZodOptional<import("zod").ZodString>;
     office: import("zod").ZodOptional<import("zod").ZodEnum<{
+        P: "P";
         H: "H";
         S: "S";
-        P: "P";
     }>>;
     party: import("zod").ZodOptional<import("zod").ZodString>;
     cycle: import("zod").ZodOptional<import("zod").ZodNumber>;
@@ -91,8 +130,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     }>>;
     has_raised_funds: import("zod").ZodOptional<import("zod").ZodBoolean>;
     include_totals: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    page: import("zod").ZodOptional<import("zod").ZodNumber>;
-    per_page: import("zod").ZodOptional<import("zod").ZodNumber>;
+    page: import("zod").ZodDefault<import("zod").ZodNumber>;
+    per_page: import("zod").ZodDefault<import("zod").ZodNumber>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
     candidates: import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
     totals: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>;
@@ -103,7 +142,12 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
         per_page: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>;
     search_criteria: import("zod").ZodOptional<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
-}, import("zod/v4/core").$strip>> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "candidate_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Single-candidate lookup by candidate_id returned no record";
+    readonly recovery: "Verify the candidate_id format (H/S/P + digits) or drop it and search by name, state, or cycle.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     query: import("zod").ZodOptional<import("zod").ZodString>;
     committee_id: import("zod").ZodOptional<import("zod").ZodString>;
     candidate_id: import("zod").ZodOptional<import("zod").ZodString>;
@@ -113,8 +157,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     designation: import("zod").ZodOptional<import("zod").ZodString>;
     cycle: import("zod").ZodOptional<import("zod").ZodNumber>;
     treasurer_name: import("zod").ZodOptional<import("zod").ZodString>;
-    page: import("zod").ZodOptional<import("zod").ZodNumber>;
-    per_page: import("zod").ZodOptional<import("zod").ZodNumber>;
+    page: import("zod").ZodDefault<import("zod").ZodNumber>;
+    per_page: import("zod").ZodDefault<import("zod").ZodNumber>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
     committees: import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
     pagination: import("zod").ZodObject<{
@@ -124,7 +168,12 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
         per_page: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>;
     search_criteria: import("zod").ZodOptional<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
-}, import("zod/v4/core").$strip>> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "committee_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Single-committee lookup by committee_id returned no record";
+    readonly recovery: "Verify the committee_id format (C + digits) or drop it and search by name, candidate_id, or type.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     mode: import("zod").ZodDefault<import("zod").ZodEnum<{
         by_size: "by_size";
         by_state: "by_state";
@@ -163,7 +212,17 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
         per_page: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>>;
     search_criteria: import("zod").ZodOptional<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
-}, import("zod/v4/core").$strip>> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "itemized_requires_committee_id";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Itemized mode invoked without a committee_id";
+    readonly recovery: "Provide a committee_id, switch to a by_size or by_state aggregate mode with candidate_id, or look up the candidate's committee with openfec_search_committees.";
+}, {
+    readonly reason: "aggregate_requires_committee_id";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "by_employer or by_occupation aggregate without a committee_id";
+    readonly recovery: "These aggregates roll up to a single committee — provide a committee_id for the spending committee.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     mode: import("zod").ZodDefault<import("zod").ZodEnum<{
         by_purpose: "by_purpose";
         by_recipient: "by_recipient";
@@ -199,7 +258,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
         per_page: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>>;
     search_criteria: import("zod").ZodOptional<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
-}, import("zod/v4/core").$strip>> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     mode: import("zod").ZodDefault<import("zod").ZodEnum<{
         itemized: "itemized";
         by_candidate: "by_candidate";
@@ -212,9 +271,9 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     }>>;
     payee_name: import("zod").ZodOptional<import("zod").ZodString>;
     candidate_office: import("zod").ZodOptional<import("zod").ZodEnum<{
+        P: "P";
         H: "H";
         S: "S";
-        P: "P";
     }>>;
     candidate_office_state: import("zod").ZodOptional<import("zod").ZodString>;
     candidate_party: import("zod").ZodOptional<import("zod").ZodString>;
@@ -243,7 +302,12 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
         per_page: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>>;
     search_criteria: import("zod").ZodOptional<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
-}, import("zod/v4/core").$strip>> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "by_candidate_requires_candidate_id";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "by_candidate mode invoked without a candidate_id";
+    readonly recovery: "Find the candidate ID via openfec_search_candidates, then pass it here to see independent expenditures supporting or opposing that candidate.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     committee_id: import("zod").ZodOptional<import("zod").ZodString>;
     candidate_id: import("zod").ZodOptional<import("zod").ZodString>;
     filer_name: import("zod").ZodOptional<import("zod").ZodString>;
@@ -252,13 +316,13 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     report_year: import("zod").ZodOptional<import("zod").ZodNumber>;
     cycle: import("zod").ZodOptional<import("zod").ZodNumber>;
     is_amended: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    most_recent: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    most_recent: import("zod").ZodDefault<import("zod").ZodBoolean>;
     min_receipt_date: import("zod").ZodOptional<import("zod").ZodString>;
     max_receipt_date: import("zod").ZodOptional<import("zod").ZodString>;
-    page: import("zod").ZodOptional<import("zod").ZodNumber>;
-    per_page: import("zod").ZodOptional<import("zod").ZodNumber>;
+    page: import("zod").ZodDefault<import("zod").ZodNumber>;
+    per_page: import("zod").ZodDefault<import("zod").ZodNumber>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    filings: import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
+    results: import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
     pagination: import("zod").ZodObject<{
         page: import("zod").ZodNumber;
         pages: import("zod").ZodNumber;
@@ -266,7 +330,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
         per_page: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>;
     search_criteria: import("zod").ZodOptional<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
-}, import("zod/v4/core").$strip>> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     query: import("zod").ZodOptional<import("zod").ZodString>;
     type: import("zod").ZodOptional<import("zod").ZodEnum<{
         advisory_opinions: "advisory_opinions";
@@ -290,5 +354,10 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
     results: import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
     total_count: import("zod").ZodNumber;
     search_criteria: import("zod").ZodOptional<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>;
-}, import("zod/v4/core").$strip>>)[];
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "missing_filter";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Called without query, type, or a specific identifier (ao_number / case_number)";
+    readonly recovery: "Provide at least a search query, document type, or specific identifier (ao_number, case_number) to scope the legal search.";
+}]>)[];
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAYrD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAU9B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAYrD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAU9B,CAAC"}

package/dist/mcp-server/tools/definitions/lookup-calendar.tool.d.ts

@@ -12,13 +12,32 @@ export declare const lookupCalendar: import("@cyanheads/mcp-ts-core").ToolDefini
     }>>;
     state: z.ZodOptional<z.ZodString>;
     office: z.ZodOptional<z.ZodEnum<{
+        P: "P";
         H: "H";
         S: "S";
-        P: "P";
     }>>;
     report_type: z.ZodOptional<z.ZodString>;
     report_year: z.ZodOptional<z.ZodNumber>;
-    category: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodEnum<{
+        20: "20";
+        21: "21";
+        22: "22";
+        23: "23";
+        24: "24";
+        25: "25";
+        26: "26";
+        27: "27";
+        28: "28";
+        29: "29";
+        32: "32";
+        33: "33";
+        34: "34";
+        36: "36";
+        37: "37";
+        38: "38";
+        39: "39";
+        40: "40";
+    }>>;
     election_year: z.ZodOptional<z.ZodNumber>;
     description: z.ZodOptional<z.ZodString>;
     min_date: z.ZodOptional<z.ZodString>;
@@ -34,5 +53,5 @@ export declare const lookupCalendar: import("@cyanheads/mcp-ts-core").ToolDefini
         per_page: z.ZodNumber;
     }, z.core.$strip>;
     search_criteria: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
-}, z.core.$strip>>;
+}, z.core.$strip>, undefined>;
 //# sourceMappingURL=lookup-calendar.tool.d.ts.map

package/dist/mcp-server/tools/definitions/lookup-calendar.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lookup-calendar.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-calendar.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAUjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuJzB,CAAC"}
+{"version":3,"file":"lookup-calendar.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-calendar.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAWjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAoKzB,CAAC"}

package/dist/mcp-server/tools/definitions/lookup-calendar.tool.js

@@ -5,9 +5,9 @@
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { getOpenFecService } from '../../../services/openfec/openfec-service.js';
-import { buildSearchCriteria, formatEmptyResult, renderRecord, SearchCriteriaSchema, } from './utils/format-helpers.js';
+import { buildSearchCriteria, formatEmptyResult, PaginationSchema, renderRecord, SearchCriteriaSchema, } from './utils/format-helpers.js';
 export const lookupCalendar = tool('openfec_lookup_calendar', {
-    description: 'Look up FEC calendar events, filing deadlines, and election dates.',
+    description: 'Look up FEC calendar events, filing deadlines, and election dates. Use to find upcoming filing windows for a committee, locate when a federal election occurred, or scope FEC events by date range and category.',
     annotations: { readOnlyHint: true, idempotentHint: true },
     input: z.object({
         mode: z
@@ -28,9 +28,28 @@ export const lookupCalendar = tool('openfec_lookup_calendar', {
             .describe('Report type code (e.g. "Q1", "Q2"). Filing deadlines mode only.'),
         report_year: z.number().int().optional().describe('Report year. Filing deadlines mode.'),
         category: z
-            .string()
+            .enum([
+            '20',
+            '21',
+            '22',
+            '23',
+            '24',
+            '25',
+            '26',
+            '27',
+            '28',
+            '29',
+            '32',
+            '33',
+            '34',
+            '36',
+            '37',
+            '38',
+            '39',
+            '40',
+        ])
             .optional()
-            .describe('Calendar category ID for events mode. Common values: "32" (reporting deadlines), "33" (election dates), "34" (quarterly filings). Events mode only.'),
+            .describe('Calendar category ID. 20=Commission Meetings, 21=Reporting Deadlines, 22=Conferences and Outreach, 23=AOs and Rules, 24=Other, 25=Quarterly, 26=Monthly, 27=Pre and Post-Elections, 28=EC Periods, 29=IE Periods, 32=Open Meetings, 33=Conferences, 34=Roundtables, 36=Election Dates, 37=Federal Holidays, 38=FEA Periods, 39=Executive Sessions, 40=Public Hearings. Events mode only.'),
         election_year: z.number().int().optional().describe('Election year. Election dates mode.'),
         description: z.string().optional().describe('Full-text event description search. Events mode.'),
         min_date: z.string().optional().describe('Earliest date (YYYY-MM-DD).'),
@@ -48,16 +67,9 @@ export const lookupCalendar = tool('openfec_lookup_calendar', {
         results: z
             .array(z
             .looseObject({})
-            .describe('A calendar record (event, filing deadline, or election date depending on mode).'))
-            .describe('Calendar records — events, filing deadlines, or election dates depending on mode.'),
-        pagination: z
-            .object({
-            page: z.number().describe('Current page number.'),
-            pages: z.number().describe('Total pages available.'),
-            count: z.number().describe('Total result count.'),
-            per_page: z.number().describe('Results per page.'),
-        })
-            .describe('Page-based pagination metadata.'),
+            .describe('Event record (mode=events), filing deadline record (mode=filing_deadlines), or election date record (mode=election_dates).'))
+            .describe('Calendar result set; events, filing deadlines, or election dates depending on mode.'),
+        pagination: PaginationSchema,
         search_criteria: SearchCriteriaSchema,
     }),
     async handler(input, ctx) {

package/dist/mcp-server/tools/definitions/lookup-calendar.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"lookup-calendar.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-calendar.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lookup-calendar.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-calendar.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,yBAAyB,EAAE;IAC5D,WAAW,EACT,kNAAkN;IACpN,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;IAEzD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;aACtD,OAAO,CAAC,QAAQ,CAAC;aACjB,QAAQ,CACP,8GAA8G,CAC/G;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0EAA0E,CAAC;QACvF,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;aACrB,QAAQ,EAAE;aACV,QAAQ,CAAC,sEAAsE,CAAC;QACnF,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,iEAAiE,CAAC;QAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QACxF,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;SACL,CAAC;aACD,QAAQ,EAAE;aACV,QAAQ,CACP,0XAA0X,CAC3X;QACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QAC1F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC/F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QACxF,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,wCAAwC,CAAC;KACtD,CAAC;IAEF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC;aACP,KAAK,CACJ,CAAC;aACE,WAAW,CAAC,EAAE,CAAC;aACf,QAAQ,CACP,4HAA4H,CAC7H,CACJ;aACA,QAAQ,CACP,qFAAqF,CACtF;QACH,UAAU,EAAE,gBAAgB;QAC5B,eAAe,EAAE,oBAAoB;KACtC,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;QAEhC,MAAM,MAAM,GAAc;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC;QAEF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACtC,qDAAqD;YACrD,IAAI,KAAK,CAAC,QAAQ;gBAAE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC;YACzD,IAAI,KAAK,CAAC,QAAQ;gBAAE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC;YACzD,IAAI,KAAK,CAAC,WAAW;gBAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;YAC9D,IAAI,KAAK,CAAC,WAAW;gBAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;YAE9D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE;gBACxC,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACtD,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aAClE,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACpC,8DAA8D;YAC9D,IAAI,KAAK,CAAC,QAAQ;gBAAE,MAAM,CAAC,iBAAiB,GAAG,KAAK,CAAC,QAAQ,CAAC;YAC9D,IAAI,KAAK,CAAC,QAAQ;gBAAE,MAAM,CAAC,iBAAiB,GAAG,KAAK,CAAC,QAAQ,CAAC;YAC9D,IAAI,KAAK,CAAC,KAAK;gBAAE,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC;YACrD,IAAI,KAAK,CAAC,MAAM;gBAAE,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;YACtD,IAAI,KAAK,CAAC,aAAa;gBAAE,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;YAEpE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE;gBACtC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,aAAa,EAAE,KAAK,CAAC,aAAa;aACnC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACrD,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aAClE,CAAC;QACJ,CAAC;QAED,kFAAkF;QAClF,IAAI,KAAK,CAAC,QAAQ;YAAE,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC3D,IAAI,KAAK,CAAC,QAAQ;YAAE,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC3D,IAAI,KAAK,CAAC,WAAW;YAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QAC9D,IAAI,KAAK,CAAC,QAAQ;YAAE,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAC,QAAQ,CAAC;QAEjE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACrD,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SAClE,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,iBAAiB,CACtB,MAAM,CAAC,eAAe,EACtB,yHAAyH,CAC1H,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,kBAAkB,IAAI,OAAO,CAAC,CAAC;YACtF,MAAM,MAAM,GAAG,KAAK,OAAO,IAAI,CAAC;YAChC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACrD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,qBAAqB,IAAI,IAAI,KAAK,MAAM,QAAQ,YAAY,CAAC,CAAC;QAEpF,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/lookup-elections.tool.d.ts

@@ -4,15 +4,16 @@
  * @module mcp-server/tools/definitions/lookup-elections.tool
  */
 import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 export declare const lookupElections: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
     mode: z.ZodDefault<z.ZodEnum<{
         summary: "summary";
         search: "search";
     }>>;
     office: z.ZodEnum<{
-        president: "president";
-        senate: "senate";
-        house: "house";
+        P: "P";
+        H: "H";
+        S: "S";
     }>;
     cycle: z.ZodNumber;
     state: z.ZodOptional<z.ZodString>;
@@ -28,5 +29,25 @@ export declare const lookupElections: import("@cyanheads/mcp-ts-core").ToolDefin
         per_page: z.ZodNumber;
     }, z.core.$strip>;
     search_criteria: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
-}, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "cycle_must_be_even";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "Cycle is an odd year";
+    readonly recovery: "Federal election cycles are two-year periods ending in even years (e.g., 2024, 2026).";
+}, {
+    readonly reason: "missing_state_for_office";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "Senate or House office without a state and without a zip";
+    readonly recovery: "Provide a two-letter state code (e.g., AZ) or a zip code to scope the senate or house race.";
+}, {
+    readonly reason: "missing_district_for_house";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "House office without a district number and without a zip";
+    readonly recovery: "Provide a two-digit district number (e.g., \"07\") or a zip code to identify the House race.";
+}, {
+    readonly reason: "summary_does_not_support_zip";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "Summary mode invoked with a zip parameter";
+    readonly recovery: "Use mode \"search\" for ZIP-based lookups, or remove zip and use state and district for summary mode.";
+}]>;
 //# sourceMappingURL=lookup-elections.tool.d.ts.map

package/dist/mcp-server/tools/definitions/lookup-elections.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lookup-elections.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-elections.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAWjD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;kBA2J1B,CAAC"}
+{"version":3,"file":"lookup-elections.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-elections.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAajE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+L1B,CAAC"}

package/dist/mcp-server/tools/definitions/lookup-elections.tool.js

@@ -4,20 +4,45 @@
  * @module mcp-server/tools/definitions/lookup-elections.tool
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
-import { invalidParams } from '@cyanheads/mcp-ts-core/errors';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 import { getOpenFecService } from '../../../services/openfec/openfec-service.js';
-import { buildSearchCriteria, formatEmptyResult, renderRecord, SearchCriteriaSchema, } from './utils/format-helpers.js';
+import { buildSearchCriteria, formatEmptyResult, PaginationSchema, renderRecord, SearchCriteriaSchema, } from './utils/format-helpers.js';
+const OFFICE_API_FORM = { H: 'house', S: 'senate', P: 'president' };
 export const lookupElections = tool('openfec_lookup_elections', {
     description: "Look up federal election races and candidate financial summaries. Find who's running in a race with fundraising totals, or get an aggregate race summary.",
     annotations: { readOnlyHint: true, idempotentHint: true },
+    errors: [
+        {
+            reason: 'cycle_must_be_even',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'Cycle is an odd year',
+            recovery: 'Federal election cycles are two-year periods ending in even years (e.g., 2024, 2026).',
+        },
+        {
+            reason: 'missing_state_for_office',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'Senate or House office without a state and without a zip',
+            recovery: 'Provide a two-letter state code (e.g., AZ) or a zip code to scope the senate or house race.',
+        },
+        {
+            reason: 'missing_district_for_house',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'House office without a district number and without a zip',
+            recovery: 'Provide a two-digit district number (e.g., "07") or a zip code to identify the House race.',
+        },
+        {
+            reason: 'summary_does_not_support_zip',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'Summary mode invoked with a zip parameter',
+            recovery: 'Use mode "search" for ZIP-based lookups, or remove zip and use state and district for summary mode.',
+        },
+    ],
     input: z.object({
         mode: z
             .enum(['search', 'summary'])
             .default('search')
             .describe('search = candidates in a race with financial totals. summary = aggregate race financial summary.'),
-        office: z
-            .enum(['president', 'senate', 'house'])
-            .describe('Office sought: president, senate, or house.'),
+        office: z.enum(['H', 'S', 'P']).describe('Office sought: H=House, S=Senate, P=President.'),
         cycle: z.number().int().describe('Election cycle year (even years only, e.g. 2024).'),
         state: z
             .string()
@@ -40,34 +65,37 @@ export const lookupElections = tool('openfec_lookup_elections', {
         results: z
             .array(z
             .looseObject({})
-            .describe('An election race record (candidate financial row or aggregate summary).'))
-            .describe('Election race records — candidates with financial data, or aggregate summary.'),
-        pagination: z
-            .object({
-            page: z.number().describe('Current page number.'),
-            pages: z.number().describe('Total pages available.'),
-            count: z.number().describe('Total result count.'),
-            per_page: z.number().describe('Results per page.'),
-        })
-            .describe('Page-based pagination metadata.'),
+            .describe('Candidate financial row (search mode) or aggregate race summary (summary mode).'))
+            .describe('Election race result set; candidate financial rows in search mode, a single aggregate summary row in summary mode.'),
+        pagination: PaginationSchema,
         search_criteria: SearchCriteriaSchema,
     }),
     async handler(input, ctx) {
         if (input.cycle % 2 !== 0) {
-            throw invalidParams('Election cycles are even years (e.g., 2024, 2026).');
+            throw ctx.fail('cycle_must_be_even', undefined, {
+                cycle: input.cycle,
+                ...ctx.recoveryFor('cycle_must_be_even'),
+            });
         }
         // ZIP resolves geography on its own — only require state/district when no zip
         if (!input.zip) {
-            if ((input.office === 'senate' || input.office === 'house') && !input.state) {
-                throw invalidParams('Senate and House election lookups require a state (or provide a zip).');
+            if ((input.office === 'S' || input.office === 'H') && !input.state) {
+                throw ctx.fail('missing_state_for_office', undefined, {
+                    office: input.office,
+                    ...ctx.recoveryFor('missing_state_for_office'),
+                });
             }
-            if (input.office === 'house' && !input.district) {
-                throw invalidParams('House election lookups require a district number (or provide a zip).');
+            if (input.office === 'H' && !input.district) {
+                throw ctx.fail('missing_district_for_house', undefined, {
+                    office: input.office,
+                    state: input.state,
+                    ...ctx.recoveryFor('missing_district_for_house'),
+                });
             }
         }
         const fec = getOpenFecService();
         const params = {
-            office: input.office,
+            office: OFFICE_API_FORM[input.office],
             cycle: input.cycle,
         };
         if (input.state)
@@ -78,7 +106,9 @@ export const lookupElections = tool('openfec_lookup_elections', {
             params.zip = input.zip;
         if (input.mode === 'summary') {
             if (input.zip) {
-                throw invalidParams('Summary mode does not support ZIP lookups. Use search mode with zip.');
+                throw ctx.fail('summary_does_not_support_zip', undefined, {
+                    ...ctx.recoveryFor('summary_does_not_support_zip'),
+                });
             }
             params.election_full = input.election_full;
             ctx.log.info('Fetching election summary', { office: input.office, cycle: input.cycle });