@cyanheads/congressgov-mcp-server 0.3.3

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 (94) hide show
  1. package/CLAUDE.md +270 -0
  2. package/Dockerfile +99 -0
  3. package/LICENSE +191 -0
  4. package/README.md +296 -0
  5. package/dist/config/server-config.d.ts +13 -0
  6. package/dist/config/server-config.d.ts.map +1 -0
  7. package/dist/config/server-config.js +22 -0
  8. package/dist/config/server-config.js.map +1 -0
  9. package/dist/index.d.ts +7 -0
  10. package/dist/index.d.ts.map +1 -0
  11. package/dist/index.js +50 -0
  12. package/dist/index.js.map +1 -0
  13. package/dist/mcp-server/prompts/definitions/bill-analysis.prompt.d.ts +11 -0
  14. package/dist/mcp-server/prompts/definitions/bill-analysis.prompt.d.ts.map +1 -0
  15. package/dist/mcp-server/prompts/definitions/bill-analysis.prompt.js +36 -0
  16. package/dist/mcp-server/prompts/definitions/bill-analysis.prompt.js.map +1 -0
  17. package/dist/mcp-server/prompts/definitions/legislative-research.prompt.d.ts +10 -0
  18. package/dist/mcp-server/prompts/definitions/legislative-research.prompt.d.ts.map +1 -0
  19. package/dist/mcp-server/prompts/definitions/legislative-research.prompt.js +47 -0
  20. package/dist/mcp-server/prompts/definitions/legislative-research.prompt.js.map +1 -0
  21. package/dist/mcp-server/resources/definitions/bill-types.resource.d.ts +8 -0
  22. package/dist/mcp-server/resources/definitions/bill-types.resource.d.ts.map +1 -0
  23. package/dist/mcp-server/resources/definitions/bill-types.resource.js +39 -0
  24. package/dist/mcp-server/resources/definitions/bill-types.resource.js.map +1 -0
  25. package/dist/mcp-server/resources/definitions/bill.resource.d.ts +11 -0
  26. package/dist/mcp-server/resources/definitions/bill.resource.d.ts.map +1 -0
  27. package/dist/mcp-server/resources/definitions/bill.resource.js +31 -0
  28. package/dist/mcp-server/resources/definitions/bill.resource.js.map +1 -0
  29. package/dist/mcp-server/resources/definitions/committee.resource.d.ts +9 -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/current-congress.resource.d.ts +8 -0
  34. package/dist/mcp-server/resources/definitions/current-congress.resource.d.ts.map +1 -0
  35. package/dist/mcp-server/resources/definitions/current-congress.resource.js +18 -0
  36. package/dist/mcp-server/resources/definitions/current-congress.resource.js.map +1 -0
  37. package/dist/mcp-server/resources/definitions/member.resource.d.ts +9 -0
  38. package/dist/mcp-server/resources/definitions/member.resource.d.ts.map +1 -0
  39. package/dist/mcp-server/resources/definitions/member.resource.js +21 -0
  40. package/dist/mcp-server/resources/definitions/member.resource.js.map +1 -0
  41. package/dist/mcp-server/tools/definitions/bill-lookup.tool.d.ts +37 -0
  42. package/dist/mcp-server/tools/definitions/bill-lookup.tool.d.ts.map +1 -0
  43. package/dist/mcp-server/tools/definitions/bill-lookup.tool.js +105 -0
  44. package/dist/mcp-server/tools/definitions/bill-lookup.tool.js.map +1 -0
  45. package/dist/mcp-server/tools/definitions/bill-summaries.tool.d.ts +23 -0
  46. package/dist/mcp-server/tools/definitions/bill-summaries.tool.d.ts.map +1 -0
  47. package/dist/mcp-server/tools/definitions/bill-summaries.tool.js +57 -0
  48. package/dist/mcp-server/tools/definitions/bill-summaries.tool.js.map +1 -0
  49. package/dist/mcp-server/tools/definitions/committee-lookup.tool.d.ts +24 -0
  50. package/dist/mcp-server/tools/definitions/committee-lookup.tool.d.ts.map +1 -0
  51. package/dist/mcp-server/tools/definitions/committee-lookup.tool.js +70 -0
  52. package/dist/mcp-server/tools/definitions/committee-lookup.tool.js.map +1 -0
  53. package/dist/mcp-server/tools/definitions/committee-reports.tool.d.ts +22 -0
  54. package/dist/mcp-server/tools/definitions/committee-reports.tool.d.ts.map +1 -0
  55. package/dist/mcp-server/tools/definitions/committee-reports.tool.js +80 -0
  56. package/dist/mcp-server/tools/definitions/committee-reports.tool.js.map +1 -0
  57. package/dist/mcp-server/tools/definitions/crs-reports.tool.d.ts +15 -0
  58. package/dist/mcp-server/tools/definitions/crs-reports.tool.d.ts.map +1 -0
  59. package/dist/mcp-server/tools/definitions/crs-reports.tool.js +41 -0
  60. package/dist/mcp-server/tools/definitions/crs-reports.tool.js.map +1 -0
  61. package/dist/mcp-server/tools/definitions/daily-record.tool.d.ts +17 -0
  62. package/dist/mcp-server/tools/definitions/daily-record.tool.d.ts.map +1 -0
  63. package/dist/mcp-server/tools/definitions/daily-record.tool.js +67 -0
  64. package/dist/mcp-server/tools/definitions/daily-record.tool.js.map +1 -0
  65. package/dist/mcp-server/tools/definitions/enacted-laws.tool.d.ts +20 -0
  66. package/dist/mcp-server/tools/definitions/enacted-laws.tool.d.ts.map +1 -0
  67. package/dist/mcp-server/tools/definitions/enacted-laws.tool.js +55 -0
  68. package/dist/mcp-server/tools/definitions/enacted-laws.tool.js.map +1 -0
  69. package/dist/mcp-server/tools/definitions/member-lookup.tool.d.ts +21 -0
  70. package/dist/mcp-server/tools/definitions/member-lookup.tool.d.ts.map +1 -0
  71. package/dist/mcp-server/tools/definitions/member-lookup.tool.js +86 -0
  72. package/dist/mcp-server/tools/definitions/member-lookup.tool.js.map +1 -0
  73. package/dist/mcp-server/tools/definitions/roll-votes.tool.d.ts +18 -0
  74. package/dist/mcp-server/tools/definitions/roll-votes.tool.d.ts.map +1 -0
  75. package/dist/mcp-server/tools/definitions/roll-votes.tool.js +65 -0
  76. package/dist/mcp-server/tools/definitions/roll-votes.tool.js.map +1 -0
  77. package/dist/mcp-server/tools/definitions/senate-nominations.tool.d.ts +21 -0
  78. package/dist/mcp-server/tools/definitions/senate-nominations.tool.d.ts.map +1 -0
  79. package/dist/mcp-server/tools/definitions/senate-nominations.tool.js +90 -0
  80. package/dist/mcp-server/tools/definitions/senate-nominations.tool.js.map +1 -0
  81. package/dist/mcp-server/tools/format-helpers.d.ts +12 -0
  82. package/dist/mcp-server/tools/format-helpers.d.ts.map +1 -0
  83. package/dist/mcp-server/tools/format-helpers.js +72 -0
  84. package/dist/mcp-server/tools/format-helpers.js.map +1 -0
  85. package/dist/services/congress-api/congress-api-service.d.ts +75 -0
  86. package/dist/services/congress-api/congress-api-service.d.ts.map +1 -0
  87. package/dist/services/congress-api/congress-api-service.js +292 -0
  88. package/dist/services/congress-api/congress-api-service.js.map +1 -0
  89. package/dist/services/congress-api/types.d.ts +122 -0
  90. package/dist/services/congress-api/types.d.ts.map +1 -0
  91. package/dist/services/congress-api/types.js +6 -0
  92. package/dist/services/congress-api/types.js.map +1 -0
  93. package/package.json +71 -0
  94. package/server.json +111 -0
package/package.json ADDED
@@ -0,0 +1,71 @@
1
+ {
2
+ "name": "@cyanheads/congressgov-mcp-server",
3
+ "version": "0.3.3",
4
+ "description": "Access U.S. congressional data - bills, votes, members, committees - through MCP. STDIO & Streamable HTTP.",
5
+ "mcpName": "io.github.cyanheads/congressgov-mcp-server",
6
+ "type": "module",
7
+ "main": "dist/index.js",
8
+ "types": "dist/index.d.ts",
9
+ "bin": {
10
+ "congressgov-mcp-server": "dist/index.js"
11
+ },
12
+ "files": ["dist/", "README.md", "LICENSE", "CLAUDE.md", "Dockerfile", "server.json"],
13
+ "scripts": {
14
+ "build": "bun scripts/build.ts",
15
+ "rebuild": "bun scripts/clean.ts && bun scripts/build.ts",
16
+ "clean": "bun scripts/clean.ts",
17
+ "devcheck": "bun scripts/devcheck.ts",
18
+ "tree": "bun scripts/tree.ts",
19
+ "format": "biome check --write --unsafe .",
20
+ "lint:mcp": "bun scripts/lint-mcp.ts",
21
+ "test": "vitest run",
22
+ "dev:stdio": "MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts",
23
+ "dev:http": "MCP_TRANSPORT_TYPE=http bun --watch src/index.ts",
24
+ "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
25
+ "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
26
+ },
27
+ "keywords": [
28
+ "mcp",
29
+ "mcp-server",
30
+ "model-context-protocol",
31
+ "congress",
32
+ "congress-gov",
33
+ "legislation",
34
+ "bills",
35
+ "legislative-data",
36
+ "typescript",
37
+ "us-government"
38
+ ],
39
+ "author": "Casey Hand <casey@cyanheads.dev> (https://github.com/cyanheads)",
40
+ "homepage": "https://github.com/cyanheads/congressgov-mcp-server#readme",
41
+ "bugs": {
42
+ "url": "https://github.com/cyanheads/congressgov-mcp-server/issues"
43
+ },
44
+ "repository": {
45
+ "type": "git",
46
+ "url": "git+https://github.com/cyanheads/congressgov-mcp-server.git"
47
+ },
48
+ "license": "Apache-2.0",
49
+ "packageManager": "bun@1.3.2",
50
+ "engines": {
51
+ "node": ">=22.0.0",
52
+ "bun": ">=1.2.0"
53
+ },
54
+ "publishConfig": {
55
+ "access": "public"
56
+ },
57
+ "dependencies": {
58
+ "@cyanheads/mcp-ts-core": "^0.1.28",
59
+ "pino-pretty": "^13.1.3"
60
+ },
61
+ "devDependencies": {
62
+ "@biomejs/biome": "^2.4.8",
63
+ "@types/node": "^25.5.0",
64
+ "depcheck": "^1.4.7",
65
+ "ignore": "^7.0.5",
66
+ "tsc-alias": "^1.8.16",
67
+ "tsx": "^4.21.0",
68
+ "typescript": "^6.0.2",
69
+ "vitest": "^4.1.1"
70
+ }
71
+ }
package/server.json ADDED
@@ -0,0 +1,111 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.cyanheads/congressgov-mcp-server",
4
+ "description": "Access U.S. congressional data - bills, votes, members, committees - through MCP. STDIO & Streamable HTTP.",
5
+ "repository": {
6
+ "url": "https://github.com/cyanheads/congressgov-mcp-server",
7
+ "source": "github"
8
+ },
9
+ "version": "0.3.3",
10
+ "packages": [
11
+ {
12
+ "registryType": "npm",
13
+ "registryBaseUrl": "https://registry.npmjs.org",
14
+ "identifier": "@cyanheads/congressgov-mcp-server",
15
+ "runtimeHint": "bun",
16
+ "version": "0.3.3",
17
+ "packageArguments": [
18
+ {
19
+ "type": "positional",
20
+ "value": "run"
21
+ },
22
+ {
23
+ "type": "positional",
24
+ "value": "start:stdio"
25
+ }
26
+ ],
27
+ "environmentVariables": [
28
+ {
29
+ "name": "CONGRESS_API_KEY",
30
+ "description": "API key from api.data.gov for the Congress.gov API.",
31
+ "format": "string",
32
+ "isRequired": true
33
+ },
34
+ {
35
+ "name": "MCP_LOG_LEVEL",
36
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
37
+ "format": "string",
38
+ "isRequired": false,
39
+ "default": "info"
40
+ }
41
+ ],
42
+ "transport": {
43
+ "type": "stdio"
44
+ }
45
+ },
46
+ {
47
+ "registryType": "npm",
48
+ "registryBaseUrl": "https://registry.npmjs.org",
49
+ "identifier": "@cyanheads/congressgov-mcp-server",
50
+ "runtimeHint": "bun",
51
+ "version": "0.3.3",
52
+ "packageArguments": [
53
+ {
54
+ "type": "positional",
55
+ "value": "run"
56
+ },
57
+ {
58
+ "type": "positional",
59
+ "value": "start:http"
60
+ }
61
+ ],
62
+ "environmentVariables": [
63
+ {
64
+ "name": "CONGRESS_API_KEY",
65
+ "description": "API key from api.data.gov for the Congress.gov API.",
66
+ "format": "string",
67
+ "isRequired": true
68
+ },
69
+ {
70
+ "name": "MCP_HTTP_HOST",
71
+ "description": "The hostname for the HTTP server.",
72
+ "format": "string",
73
+ "isRequired": false,
74
+ "default": "127.0.0.1"
75
+ },
76
+ {
77
+ "name": "MCP_HTTP_PORT",
78
+ "description": "The port to run the HTTP server on.",
79
+ "format": "string",
80
+ "isRequired": false,
81
+ "default": "3010"
82
+ },
83
+ {
84
+ "name": "MCP_HTTP_ENDPOINT_PATH",
85
+ "description": "The endpoint path for the MCP server.",
86
+ "format": "string",
87
+ "isRequired": false,
88
+ "default": "/mcp"
89
+ },
90
+ {
91
+ "name": "MCP_AUTH_MODE",
92
+ "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
93
+ "format": "string",
94
+ "isRequired": false,
95
+ "default": "none"
96
+ },
97
+ {
98
+ "name": "MCP_LOG_LEVEL",
99
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
100
+ "format": "string",
101
+ "isRequired": false,
102
+ "default": "info"
103
+ }
104
+ ],
105
+ "transport": {
106
+ "type": "streamable-http",
107
+ "url": "http://localhost:3010/mcp"
108
+ }
109
+ }
110
+ ]
111
+ }