@cyanheads/openfec-mcp-server 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/CLAUDE.md +328 -0
  2. package/Dockerfile +99 -0
  3. package/LICENSE +191 -0
  4. package/README.md +297 -0
  5. package/dist/config/server-config.d.ts +17 -0
  6. package/dist/config/server-config.d.ts.map +1 -0
  7. package/dist/config/server-config.js +31 -0
  8. package/dist/config/server-config.js.map +1 -0
  9. package/dist/index.d.ts +8 -0
  10. package/dist/index.d.ts.map +1 -0
  11. package/dist/index.js +20 -0
  12. package/dist/index.js.map +1 -0
  13. package/dist/mcp-server/prompts/definitions/campaign-analysis.prompt.d.ts +13 -0
  14. package/dist/mcp-server/prompts/definitions/campaign-analysis.prompt.d.ts.map +1 -0
  15. package/dist/mcp-server/prompts/definitions/campaign-analysis.prompt.js +79 -0
  16. package/dist/mcp-server/prompts/definitions/campaign-analysis.prompt.js.map +1 -0
  17. package/dist/mcp-server/prompts/definitions/index.d.ts +12 -0
  18. package/dist/mcp-server/prompts/definitions/index.d.ts.map +1 -0
  19. package/dist/mcp-server/prompts/definitions/index.js +10 -0
  20. package/dist/mcp-server/prompts/definitions/index.js.map +1 -0
  21. package/dist/mcp-server/prompts/definitions/money-trail.prompt.d.ts +13 -0
  22. package/dist/mcp-server/prompts/definitions/money-trail.prompt.d.ts.map +1 -0
  23. package/dist/mcp-server/prompts/definitions/money-trail.prompt.js +78 -0
  24. package/dist/mcp-server/prompts/definitions/money-trail.prompt.js.map +1 -0
  25. package/dist/mcp-server/resources/definitions/candidate.resource.d.ts +10 -0
  26. package/dist/mcp-server/resources/definitions/candidate.resource.d.ts.map +1 -0
  27. package/dist/mcp-server/resources/definitions/candidate.resource.js +28 -0
  28. package/dist/mcp-server/resources/definitions/candidate.resource.js.map +1 -0
  29. package/dist/mcp-server/resources/definitions/committee.resource.d.ts +10 -0
  30. package/dist/mcp-server/resources/definitions/committee.resource.d.ts.map +1 -0
  31. package/dist/mcp-server/resources/definitions/committee.resource.js +26 -0
  32. package/dist/mcp-server/resources/definitions/committee.resource.js.map +1 -0
  33. package/dist/mcp-server/resources/definitions/election.resource.d.ts +25 -0
  34. package/dist/mcp-server/resources/definitions/election.resource.d.ts.map +1 -0
  35. package/dist/mcp-server/resources/definitions/election.resource.js +73 -0
  36. package/dist/mcp-server/resources/definitions/election.resource.js.map +1 -0
  37. package/dist/mcp-server/resources/definitions/index.d.ts +16 -0
  38. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  39. package/dist/mcp-server/resources/definitions/index.js +18 -0
  40. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  41. package/dist/mcp-server/tools/definitions/index.d.ts +285 -0
  42. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  43. package/dist/mcp-server/tools/definitions/index.js +34 -0
  44. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  45. package/dist/mcp-server/tools/definitions/lookup-calendar.tool.d.ts +37 -0
  46. package/dist/mcp-server/tools/definitions/lookup-calendar.tool.d.ts.map +1 -0
  47. package/dist/mcp-server/tools/definitions/lookup-calendar.tool.js +172 -0
  48. package/dist/mcp-server/tools/definitions/lookup-calendar.tool.js.map +1 -0
  49. package/dist/mcp-server/tools/definitions/lookup-elections.tool.d.ts +31 -0
  50. package/dist/mcp-server/tools/definitions/lookup-elections.tool.d.ts.map +1 -0
  51. package/dist/mcp-server/tools/definitions/lookup-elections.tool.js +134 -0
  52. package/dist/mcp-server/tools/definitions/lookup-elections.tool.js.map +1 -0
  53. package/dist/mcp-server/tools/definitions/search-candidates.tool.d.ts +46 -0
  54. package/dist/mcp-server/tools/definitions/search-candidates.tool.d.ts.map +1 -0
  55. package/dist/mcp-server/tools/definitions/search-candidates.tool.js +170 -0
  56. package/dist/mcp-server/tools/definitions/search-candidates.tool.js.map +1 -0
  57. package/dist/mcp-server/tools/definitions/search-committees.tool.d.ts +29 -0
  58. package/dist/mcp-server/tools/definitions/search-committees.tool.d.ts.map +1 -0
  59. package/dist/mcp-server/tools/definitions/search-committees.tool.js +120 -0
  60. package/dist/mcp-server/tools/definitions/search-committees.tool.js.map +1 -0
  61. package/dist/mcp-server/tools/definitions/search-contributions.tool.d.ts +47 -0
  62. package/dist/mcp-server/tools/definitions/search-contributions.tool.d.ts.map +1 -0
  63. package/dist/mcp-server/tools/definitions/search-contributions.tool.js +252 -0
  64. package/dist/mcp-server/tools/definitions/search-contributions.tool.js.map +1 -0
  65. package/dist/mcp-server/tools/definitions/search-disbursements.tool.d.ts +43 -0
  66. package/dist/mcp-server/tools/definitions/search-disbursements.tool.d.ts.map +1 -0
  67. package/dist/mcp-server/tools/definitions/search-disbursements.tool.js +212 -0
  68. package/dist/mcp-server/tools/definitions/search-disbursements.tool.js.map +1 -0
  69. package/dist/mcp-server/tools/definitions/search-expenditures.tool.d.ts +52 -0
  70. package/dist/mcp-server/tools/definitions/search-expenditures.tool.d.ts.map +1 -0
  71. package/dist/mcp-server/tools/definitions/search-expenditures.tool.js +247 -0
  72. package/dist/mcp-server/tools/definitions/search-expenditures.tool.js.map +1 -0
  73. package/dist/mcp-server/tools/definitions/search-filings.tool.d.ts +31 -0
  74. package/dist/mcp-server/tools/definitions/search-filings.tool.d.ts.map +1 -0
  75. package/dist/mcp-server/tools/definitions/search-filings.tool.js +123 -0
  76. package/dist/mcp-server/tools/definitions/search-filings.tool.js.map +1 -0
  77. package/dist/mcp-server/tools/definitions/search-legal.tool.d.ts +32 -0
  78. package/dist/mcp-server/tools/definitions/search-legal.tool.d.ts.map +1 -0
  79. package/dist/mcp-server/tools/definitions/search-legal.tool.js +179 -0
  80. package/dist/mcp-server/tools/definitions/search-legal.tool.js.map +1 -0
  81. package/dist/mcp-server/tools/definitions/utils/format-helpers.d.ts +19 -0
  82. package/dist/mcp-server/tools/definitions/utils/format-helpers.d.ts.map +1 -0
  83. package/dist/mcp-server/tools/definitions/utils/format-helpers.js +19 -0
  84. package/dist/mcp-server/tools/definitions/utils/format-helpers.js.map +1 -0
  85. package/dist/mcp-server/tools/definitions/utils/id-validators.d.ts +11 -0
  86. package/dist/mcp-server/tools/definitions/utils/id-validators.d.ts.map +1 -0
  87. package/dist/mcp-server/tools/definitions/utils/id-validators.js +22 -0
  88. package/dist/mcp-server/tools/definitions/utils/id-validators.js.map +1 -0
  89. package/dist/services/openfec/openfec-service.d.ts +54 -0
  90. package/dist/services/openfec/openfec-service.d.ts.map +1 -0
  91. package/dist/services/openfec/openfec-service.js +384 -0
  92. package/dist/services/openfec/openfec-service.js.map +1 -0
  93. package/dist/services/openfec/types.d.ts +86 -0
  94. package/dist/services/openfec/types.d.ts.map +1 -0
  95. package/dist/services/openfec/types.js +8 -0
  96. package/dist/services/openfec/types.js.map +1 -0
  97. package/package.json +91 -0
  98. package/server.json +97 -0
package/server.json ADDED
@@ -0,0 +1,97 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.cyanheads/openfec-mcp-server",
4
+ "description": "Access FEC campaign finance data through MCP. Query data about candidates, money trails, and election filings. STDIO & Streamable HTTP.",
5
+ "repository": {
6
+ "url": "https://github.com/cyanheads/openfec-mcp-server",
7
+ "source": "github"
8
+ },
9
+ "version": "0.2.2",
10
+ "packages": [
11
+ {
12
+ "registryType": "npm",
13
+ "registryBaseUrl": "https://registry.npmjs.org",
14
+ "identifier": "@cyanheads/openfec-mcp-server",
15
+ "runtimeHint": "bun",
16
+ "version": "0.2.2",
17
+ "packageArguments": [
18
+ { "type": "positional", "value": "run" },
19
+ { "type": "positional", "value": "start:stdio" }
20
+ ],
21
+ "environmentVariables": [
22
+ {
23
+ "name": "FEC_API_KEY",
24
+ "description": "OpenFEC API key. Get a free key at https://api.data.gov/signup/",
25
+ "format": "string",
26
+ "isRequired": true
27
+ },
28
+ {
29
+ "name": "MCP_LOG_LEVEL",
30
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
31
+ "format": "string",
32
+ "isRequired": false,
33
+ "default": "info"
34
+ }
35
+ ],
36
+ "transport": { "type": "stdio" }
37
+ },
38
+ {
39
+ "registryType": "npm",
40
+ "registryBaseUrl": "https://registry.npmjs.org",
41
+ "identifier": "@cyanheads/openfec-mcp-server",
42
+ "runtimeHint": "bun",
43
+ "version": "0.2.2",
44
+ "packageArguments": [
45
+ { "type": "positional", "value": "run" },
46
+ { "type": "positional", "value": "start:http" }
47
+ ],
48
+ "environmentVariables": [
49
+ {
50
+ "name": "FEC_API_KEY",
51
+ "description": "OpenFEC API key. Get a free key at https://api.data.gov/signup/",
52
+ "format": "string",
53
+ "isRequired": true
54
+ },
55
+ {
56
+ "name": "MCP_HTTP_HOST",
57
+ "description": "The hostname for the HTTP server.",
58
+ "format": "string",
59
+ "isRequired": false,
60
+ "default": "127.0.0.1"
61
+ },
62
+ {
63
+ "name": "MCP_HTTP_PORT",
64
+ "description": "The port to run the HTTP server on.",
65
+ "format": "string",
66
+ "isRequired": false,
67
+ "default": "3010"
68
+ },
69
+ {
70
+ "name": "MCP_HTTP_ENDPOINT_PATH",
71
+ "description": "The endpoint path for the MCP server.",
72
+ "format": "string",
73
+ "isRequired": false,
74
+ "default": "/mcp"
75
+ },
76
+ {
77
+ "name": "MCP_AUTH_MODE",
78
+ "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
79
+ "format": "string",
80
+ "isRequired": false,
81
+ "default": "none"
82
+ },
83
+ {
84
+ "name": "MCP_LOG_LEVEL",
85
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
86
+ "format": "string",
87
+ "isRequired": false,
88
+ "default": "info"
89
+ }
90
+ ],
91
+ "transport": {
92
+ "type": "streamable-http",
93
+ "url": "http://localhost:3010/mcp"
94
+ }
95
+ }
96
+ ]
97
+ }