@cyanheads/openstates-mcp-server 0.1.1

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 (77) hide show
  1. package/CLAUDE.md +397 -0
  2. package/Dockerfile +99 -0
  3. package/LICENSE +201 -0
  4. package/README.md +324 -0
  5. package/changelog/0.1.x/0.1.0.md +23 -0
  6. package/changelog/0.1.x/0.1.1.md +29 -0
  7. package/changelog/template.md +119 -0
  8. package/dist/config/server-config.d.ts +13 -0
  9. package/dist/config/server-config.d.ts.map +1 -0
  10. package/dist/config/server-config.js +19 -0
  11. package/dist/config/server-config.js.map +1 -0
  12. package/dist/index.d.ts +7 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +50 -0
  15. package/dist/index.js.map +1 -0
  16. package/dist/mcp-server/prompts/definitions/bill-research.prompt.d.ts +11 -0
  17. package/dist/mcp-server/prompts/definitions/bill-research.prompt.d.ts.map +1 -0
  18. package/dist/mcp-server/prompts/definitions/bill-research.prompt.js +65 -0
  19. package/dist/mcp-server/prompts/definitions/bill-research.prompt.js.map +1 -0
  20. package/dist/mcp-server/prompts/definitions/legislator-profile.prompt.d.ts +10 -0
  21. package/dist/mcp-server/prompts/definitions/legislator-profile.prompt.d.ts.map +1 -0
  22. package/dist/mcp-server/prompts/definitions/legislator-profile.prompt.js +55 -0
  23. package/dist/mcp-server/prompts/definitions/legislator-profile.prompt.js.map +1 -0
  24. package/dist/mcp-server/resources/definitions/jurisdiction.resource.d.ts +9 -0
  25. package/dist/mcp-server/resources/definitions/jurisdiction.resource.d.ts.map +1 -0
  26. package/dist/mcp-server/resources/definitions/jurisdiction.resource.js +60 -0
  27. package/dist/mcp-server/resources/definitions/jurisdiction.resource.js.map +1 -0
  28. package/dist/mcp-server/tools/definitions/get-bill.tool.d.ts +121 -0
  29. package/dist/mcp-server/tools/definitions/get-bill.tool.d.ts.map +1 -0
  30. package/dist/mcp-server/tools/definitions/get-bill.tool.js +319 -0
  31. package/dist/mcp-server/tools/definitions/get-bill.tool.js.map +1 -0
  32. package/dist/mcp-server/tools/definitions/get-committee.tool.d.ts +30 -0
  33. package/dist/mcp-server/tools/definitions/get-committee.tool.d.ts.map +1 -0
  34. package/dist/mcp-server/tools/definitions/get-committee.tool.js +89 -0
  35. package/dist/mcp-server/tools/definitions/get-committee.tool.js.map +1 -0
  36. package/dist/mcp-server/tools/definitions/get-event.tool.d.ts +65 -0
  37. package/dist/mcp-server/tools/definitions/get-event.tool.d.ts.map +1 -0
  38. package/dist/mcp-server/tools/definitions/get-event.tool.js +231 -0
  39. package/dist/mcp-server/tools/definitions/get-event.tool.js.map +1 -0
  40. package/dist/mcp-server/tools/definitions/get-jurisdiction.tool.d.ts +34 -0
  41. package/dist/mcp-server/tools/definitions/get-jurisdiction.tool.d.ts.map +1 -0
  42. package/dist/mcp-server/tools/definitions/get-jurisdiction.tool.js +99 -0
  43. package/dist/mcp-server/tools/definitions/get-jurisdiction.tool.js.map +1 -0
  44. package/dist/mcp-server/tools/definitions/get-legislators-by-location.tool.d.ts +53 -0
  45. package/dist/mcp-server/tools/definitions/get-legislators-by-location.tool.d.ts.map +1 -0
  46. package/dist/mcp-server/tools/definitions/get-legislators-by-location.tool.js +156 -0
  47. package/dist/mcp-server/tools/definitions/get-legislators-by-location.tool.js.map +1 -0
  48. package/dist/mcp-server/tools/definitions/list-jurisdictions.tool.d.ts +42 -0
  49. package/dist/mcp-server/tools/definitions/list-jurisdictions.tool.d.ts.map +1 -0
  50. package/dist/mcp-server/tools/definitions/list-jurisdictions.tool.js +110 -0
  51. package/dist/mcp-server/tools/definitions/list-jurisdictions.tool.js.map +1 -0
  52. package/dist/mcp-server/tools/definitions/search-bills.tool.d.ts +102 -0
  53. package/dist/mcp-server/tools/definitions/search-bills.tool.d.ts.map +1 -0
  54. package/dist/mcp-server/tools/definitions/search-bills.tool.js +285 -0
  55. package/dist/mcp-server/tools/definitions/search-bills.tool.js.map +1 -0
  56. package/dist/mcp-server/tools/definitions/search-committees.tool.d.ts +44 -0
  57. package/dist/mcp-server/tools/definitions/search-committees.tool.d.ts.map +1 -0
  58. package/dist/mcp-server/tools/definitions/search-committees.tool.js +127 -0
  59. package/dist/mcp-server/tools/definitions/search-committees.tool.js.map +1 -0
  60. package/dist/mcp-server/tools/definitions/search-events.tool.d.ts +62 -0
  61. package/dist/mcp-server/tools/definitions/search-events.tool.d.ts.map +1 -0
  62. package/dist/mcp-server/tools/definitions/search-events.tool.js +198 -0
  63. package/dist/mcp-server/tools/definitions/search-events.tool.js.map +1 -0
  64. package/dist/mcp-server/tools/definitions/search-people.tool.d.ts +64 -0
  65. package/dist/mcp-server/tools/definitions/search-people.tool.d.ts.map +1 -0
  66. package/dist/mcp-server/tools/definitions/search-people.tool.js +193 -0
  67. package/dist/mcp-server/tools/definitions/search-people.tool.js.map +1 -0
  68. package/dist/services/openstates/openstates-service.d.ts +30 -0
  69. package/dist/services/openstates/openstates-service.d.ts.map +1 -0
  70. package/dist/services/openstates/openstates-service.js +246 -0
  71. package/dist/services/openstates/openstates-service.js.map +1 -0
  72. package/dist/services/openstates/types.d.ts +324 -0
  73. package/dist/services/openstates/types.d.ts.map +1 -0
  74. package/dist/services/openstates/types.js +6 -0
  75. package/dist/services/openstates/types.js.map +1 -0
  76. package/package.json +91 -0
  77. package/server.json +99 -0
@@ -0,0 +1,324 @@
1
+ /**
2
+ * @fileoverview Domain types for the Open States API v3.
3
+ * @module services/openstates/types
4
+ */
5
+ export interface PaginationMeta {
6
+ max_page: number;
7
+ page: number;
8
+ per_page: number;
9
+ total_items: number;
10
+ }
11
+ export interface CompactJurisdiction {
12
+ id: string;
13
+ name: string;
14
+ }
15
+ export interface CompactOrganization {
16
+ classification: string;
17
+ name: string;
18
+ }
19
+ export interface CompactPerson {
20
+ id: string;
21
+ name: string;
22
+ }
23
+ export interface BillAbstract {
24
+ abstract: string;
25
+ note: string;
26
+ }
27
+ export interface BillDocumentLink {
28
+ media_type: string;
29
+ url: string;
30
+ }
31
+ export interface BillDocument {
32
+ date: string;
33
+ id: string;
34
+ links: BillDocumentLink[];
35
+ note: string;
36
+ }
37
+ export interface BillAction {
38
+ classification: string[];
39
+ date: string;
40
+ description: string;
41
+ id: string;
42
+ order: number;
43
+ organization: CompactOrganization;
44
+ }
45
+ export interface BillSponsorship {
46
+ classification: string;
47
+ entity_type: string;
48
+ id: string;
49
+ name: string;
50
+ person?: CompactPerson;
51
+ primary: boolean;
52
+ }
53
+ export interface VoteCount {
54
+ option: string;
55
+ value: number;
56
+ }
57
+ export interface PersonVote {
58
+ id: string;
59
+ option: string;
60
+ voter?: CompactPerson;
61
+ voter_name: string;
62
+ }
63
+ export interface VoteEvent {
64
+ counts: VoteCount[];
65
+ id: string;
66
+ identifier: string;
67
+ motion_text: string;
68
+ result: string;
69
+ start_date: string;
70
+ votes: PersonVote[];
71
+ }
72
+ export interface RelatedBill {
73
+ identifier: string;
74
+ legislative_session: string;
75
+ relation_type: string;
76
+ }
77
+ export interface Bill {
78
+ abstracts?: BillAbstract[];
79
+ actions?: BillAction[];
80
+ classification: string[];
81
+ documents?: BillDocument[];
82
+ first_action_date: string | null;
83
+ from_organization: CompactOrganization;
84
+ id: string;
85
+ identifier: string;
86
+ jurisdiction: CompactJurisdiction;
87
+ latest_action_date: string | null;
88
+ latest_action_description: string | null;
89
+ latest_passage_date: string | null;
90
+ openstates_url?: string;
91
+ other_identifiers?: Array<{
92
+ identifier: string;
93
+ scheme: string;
94
+ }>;
95
+ other_titles?: Array<{
96
+ title: string;
97
+ note: string;
98
+ }>;
99
+ related_bills?: RelatedBill[];
100
+ session: string;
101
+ sources?: Array<{
102
+ url: string;
103
+ note: string;
104
+ }>;
105
+ sponsorships?: BillSponsorship[];
106
+ subject: string[];
107
+ title: string;
108
+ versions?: BillDocument[];
109
+ votes?: VoteEvent[];
110
+ }
111
+ export interface BillListResponse {
112
+ pagination: PaginationMeta;
113
+ results: Bill[];
114
+ }
115
+ export interface PersonRole {
116
+ district: string | null;
117
+ org_classification: string;
118
+ title: string;
119
+ }
120
+ export interface PersonOffice {
121
+ address?: string;
122
+ classification: string;
123
+ fax?: string;
124
+ name: string;
125
+ voice?: string;
126
+ }
127
+ export interface PersonLink {
128
+ note: string;
129
+ url: string;
130
+ }
131
+ export interface RawPerson {
132
+ current_role?: PersonRole | null;
133
+ email?: string;
134
+ family_name?: string;
135
+ given_name?: string;
136
+ id: string;
137
+ jurisdiction?: CompactJurisdiction;
138
+ links?: PersonLink[];
139
+ name: string;
140
+ offices?: PersonOffice[];
141
+ openstates_url?: string;
142
+ other_identifiers?: Array<{
143
+ identifier: string;
144
+ scheme: string;
145
+ }>;
146
+ other_names?: Array<{
147
+ name: string;
148
+ note: string;
149
+ }>;
150
+ party?: string | Array<{
151
+ name: string;
152
+ end_date?: string | null;
153
+ }>;
154
+ sources?: Array<{
155
+ url: string;
156
+ note: string;
157
+ }>;
158
+ }
159
+ export interface Person {
160
+ current_role: PersonRole | null;
161
+ email: string;
162
+ family_name: string;
163
+ given_name: string;
164
+ id: string;
165
+ jurisdiction: CompactJurisdiction;
166
+ links?: PersonLink[];
167
+ name: string;
168
+ offices?: PersonOffice[];
169
+ openstates_url: string;
170
+ party: string;
171
+ }
172
+ export interface PersonListResponse {
173
+ pagination: PaginationMeta;
174
+ results: Person[];
175
+ }
176
+ export interface CommitteeMembership {
177
+ person?: CompactPerson;
178
+ person_id: string;
179
+ person_name: string;
180
+ role: string;
181
+ }
182
+ export interface Committee {
183
+ classification: string;
184
+ id: string;
185
+ jurisdiction?: CompactJurisdiction;
186
+ links?: PersonLink[];
187
+ memberships?: CommitteeMembership[];
188
+ name: string;
189
+ parent_id: string | null;
190
+ sources?: Array<{
191
+ url: string;
192
+ note: string;
193
+ }>;
194
+ }
195
+ export interface CommitteeListResponse {
196
+ pagination: PaginationMeta;
197
+ results: Committee[];
198
+ }
199
+ export interface EventLocation {
200
+ coordinates?: unknown;
201
+ name: string;
202
+ url?: string;
203
+ }
204
+ export interface EventParticipant {
205
+ entity_type: string;
206
+ name: string;
207
+ organization?: unknown;
208
+ person?: unknown;
209
+ role: string;
210
+ }
211
+ export interface AgendaRelatedEntity {
212
+ bill?: unknown;
213
+ entity_type: string;
214
+ name: string;
215
+ organization?: unknown;
216
+ person?: unknown;
217
+ }
218
+ export interface AgendaItem {
219
+ classification: string[];
220
+ description: string;
221
+ related_entities: AgendaRelatedEntity[];
222
+ subjects: string[];
223
+ }
224
+ export interface Event {
225
+ agenda?: AgendaItem[];
226
+ classification: string;
227
+ description: string;
228
+ documents?: PersonLink[];
229
+ end_date: string | undefined;
230
+ id: string;
231
+ jurisdiction: CompactJurisdiction;
232
+ links?: PersonLink[];
233
+ location?: EventLocation;
234
+ media?: PersonLink[];
235
+ name: string;
236
+ participants?: EventParticipant[];
237
+ sources?: Array<{
238
+ url: string;
239
+ note: string;
240
+ }>;
241
+ start_date: string;
242
+ status: string;
243
+ }
244
+ export interface EventListResponse {
245
+ pagination: PaginationMeta;
246
+ results: Event[];
247
+ }
248
+ export interface LegislativeSession {
249
+ classification: string;
250
+ end_date: string;
251
+ identifier: string;
252
+ name: string;
253
+ start_date: string;
254
+ }
255
+ export interface RunPlan {
256
+ end_time?: string;
257
+ start_time: string;
258
+ success?: boolean;
259
+ }
260
+ export interface Jurisdiction {
261
+ classification: string;
262
+ id: string;
263
+ latest_bill_update: string;
264
+ latest_people_update: string;
265
+ latest_runs?: RunPlan[];
266
+ legislative_sessions?: LegislativeSession[];
267
+ name: string;
268
+ organizations?: unknown[];
269
+ url: string;
270
+ }
271
+ export interface JurisdictionListResponse {
272
+ pagination: PaginationMeta;
273
+ results: Jurisdiction[];
274
+ }
275
+ export interface BillSearchParams {
276
+ action_since?: string | undefined;
277
+ chamber?: string | undefined;
278
+ classification?: string | undefined;
279
+ include?: string[] | undefined;
280
+ jurisdiction?: string | undefined;
281
+ page?: number | undefined;
282
+ per_page?: number | undefined;
283
+ q?: string | undefined;
284
+ session?: string | undefined;
285
+ sort?: string | undefined;
286
+ sponsor?: string | undefined;
287
+ sponsor_classification?: string | undefined;
288
+ subject?: string[] | undefined;
289
+ updated_since?: string | undefined;
290
+ }
291
+ export interface PeopleSearchParams {
292
+ district?: string | undefined;
293
+ include?: string[] | undefined;
294
+ jurisdiction?: string | undefined;
295
+ name?: string | undefined;
296
+ org_classification?: string | undefined;
297
+ page?: number | undefined;
298
+ per_page?: number | undefined;
299
+ }
300
+ export interface CommitteeSearchParams {
301
+ chamber?: string | undefined;
302
+ classification?: string | undefined;
303
+ include?: string[] | undefined;
304
+ jurisdiction?: string | undefined;
305
+ page?: number | undefined;
306
+ parent?: string | undefined;
307
+ per_page?: number | undefined;
308
+ }
309
+ export interface EventSearchParams {
310
+ after?: string | undefined;
311
+ before?: string | undefined;
312
+ include?: string[] | undefined;
313
+ jurisdiction?: string | undefined;
314
+ page?: number | undefined;
315
+ per_page?: number | undefined;
316
+ require_bills?: boolean | undefined;
317
+ }
318
+ export interface JurisdictionListParams {
319
+ classification?: string | undefined;
320
+ include?: string[] | undefined;
321
+ page?: number | undefined;
322
+ per_page?: number | undefined;
323
+ }
324
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/openstates/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @fileoverview Domain types for the Open States API v3.
3
+ * @module services/openstates/types
4
+ */
5
+ export {};
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/openstates/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
package/package.json ADDED
@@ -0,0 +1,91 @@
1
+ {
2
+ "name": "@cyanheads/openstates-mcp-server",
3
+ "version": "0.1.1",
4
+ "mcpName": "io.github.cyanheads/openstates-mcp-server",
5
+ "description": "Search bills, legislators, committees, and events across all 50 US states, DC, and Puerto Rico via MCP. STDIO or Streamable HTTP.",
6
+ "type": "module",
7
+ "main": "dist/index.js",
8
+ "types": "dist/index.d.ts",
9
+ "bin": {
10
+ "openstates-mcp-server": "dist/index.js"
11
+ },
12
+ "files": [
13
+ "changelog/",
14
+ "dist/",
15
+ "README.md",
16
+ "LICENSE",
17
+ "CLAUDE.md",
18
+ "AGENTS.md",
19
+ "Dockerfile",
20
+ "server.json"
21
+ ],
22
+ "scripts": {
23
+ "build": "tsx scripts/build.ts",
24
+ "rebuild": "tsx scripts/clean.ts && tsx scripts/build.ts",
25
+ "clean": "tsx scripts/clean.ts",
26
+ "devcheck": "tsx scripts/devcheck.ts",
27
+ "audit:refresh": "rm -f bun.lock && bun install && bun audit",
28
+ "tree": "tsx scripts/tree.ts",
29
+ "list-skills": "tsx scripts/list-skills.ts",
30
+ "format": "biome check --write --unsafe .",
31
+ "lint:mcp": "tsx scripts/lint-mcp.ts",
32
+ "lint:packaging": "tsx scripts/lint-packaging.ts",
33
+ "bundle": "npm run build && npx -y @anthropic-ai/mcpb pack . dist/openstates-mcp-server.mcpb",
34
+ "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
35
+ "changelog:build": "tsx scripts/build-changelog.ts",
36
+ "changelog:check": "tsx scripts/build-changelog.ts --check",
37
+ "test": "vitest run",
38
+ "start": "node dist/index.js",
39
+ "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
40
+ "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
41
+ },
42
+ "keywords": [
43
+ "mcp",
44
+ "mcp-server",
45
+ "model-context-protocol",
46
+ "ai",
47
+ "llm",
48
+ "bun",
49
+ "stdio",
50
+ "streamable-http",
51
+ "legislation",
52
+ "openstates",
53
+ "state-legislature",
54
+ "bills",
55
+ "legislators",
56
+ "open-states"
57
+ ],
58
+ "repository": {
59
+ "type": "git",
60
+ "url": "git+https://github.com/cyanheads/openstates-mcp-server.git"
61
+ },
62
+ "homepage": "https://github.com/cyanheads/openstates-mcp-server#readme",
63
+ "bugs": {
64
+ "url": "https://github.com/cyanheads/openstates-mcp-server/issues"
65
+ },
66
+ "author": "Casey Hand <casey@caseyjhand.com> (https://github.com/cyanheads/openstates-mcp-server#readme)",
67
+ "license": "Apache-2.0",
68
+ "engines": {
69
+ "bun": ">=1.3.0",
70
+ "node": ">=24.0.0"
71
+ },
72
+ "packageManager": "bun@1.3.0",
73
+ "publishConfig": {
74
+ "access": "public"
75
+ },
76
+ "dependencies": {
77
+ "@cyanheads/mcp-ts-core": "^0.9.7",
78
+ "pino-pretty": "^13.1.3",
79
+ "zod": "^4.4.3"
80
+ },
81
+ "devDependencies": {
82
+ "@biomejs/biome": "^2.4.7",
83
+ "@types/node": "^25.6.0",
84
+ "depcheck": "^1.4.7",
85
+ "ignore": "^7.0.5",
86
+ "tsc-alias": "^1.8.16",
87
+ "tsx": "^4.19.0",
88
+ "typescript": "^5.9.3",
89
+ "vitest": "^4.1.0"
90
+ }
91
+ }
package/server.json ADDED
@@ -0,0 +1,99 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.cyanheads/openstates-mcp-server",
4
+ "description": "Search bills, legislators, committees, and events across all 50 US states, DC, and Puerto Rico.",
5
+ "repository": {
6
+ "url": "https://github.com/cyanheads/openstates-mcp-server",
7
+ "source": "github"
8
+ },
9
+ "version": "0.1.1",
10
+ "packages": [
11
+ {
12
+ "registryType": "npm",
13
+ "registryBaseUrl": "https://registry.npmjs.org",
14
+ "identifier": "@cyanheads/openstates-mcp-server",
15
+ "runtimeHint": "bun",
16
+ "version": "0.1.1",
17
+ "packageArguments": [
18
+ { "type": "positional", "value": "run" },
19
+ { "type": "positional", "value": "start:stdio" }
20
+ ],
21
+ "environmentVariables": [
22
+ {
23
+ "name": "OPENSTATES_API_KEY",
24
+ "description": "Open States API key from open.pluralpolicy.com. Required to make any API requests.",
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": {
37
+ "type": "stdio"
38
+ }
39
+ },
40
+ {
41
+ "registryType": "npm",
42
+ "registryBaseUrl": "https://registry.npmjs.org",
43
+ "identifier": "@cyanheads/openstates-mcp-server",
44
+ "runtimeHint": "bun",
45
+ "version": "0.1.1",
46
+ "packageArguments": [
47
+ { "type": "positional", "value": "run" },
48
+ { "type": "positional", "value": "start:http" }
49
+ ],
50
+ "environmentVariables": [
51
+ {
52
+ "name": "OPENSTATES_API_KEY",
53
+ "description": "Open States API key from open.pluralpolicy.com. Required to make any API requests.",
54
+ "format": "string",
55
+ "isRequired": true
56
+ },
57
+ {
58
+ "name": "MCP_HTTP_HOST",
59
+ "description": "The hostname for the HTTP server.",
60
+ "format": "string",
61
+ "isRequired": false,
62
+ "default": "127.0.0.1"
63
+ },
64
+ {
65
+ "name": "MCP_HTTP_PORT",
66
+ "description": "The port to run the HTTP server on.",
67
+ "format": "string",
68
+ "isRequired": false,
69
+ "default": "3010"
70
+ },
71
+ {
72
+ "name": "MCP_HTTP_ENDPOINT_PATH",
73
+ "description": "The endpoint path for the MCP server.",
74
+ "format": "string",
75
+ "isRequired": false,
76
+ "default": "/mcp"
77
+ },
78
+ {
79
+ "name": "MCP_AUTH_MODE",
80
+ "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
81
+ "format": "string",
82
+ "isRequired": false,
83
+ "default": "none"
84
+ },
85
+ {
86
+ "name": "MCP_LOG_LEVEL",
87
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
88
+ "format": "string",
89
+ "isRequired": false,
90
+ "default": "info"
91
+ }
92
+ ],
93
+ "transport": {
94
+ "type": "streamable-http",
95
+ "url": "http://localhost:3010/mcp"
96
+ }
97
+ }
98
+ ]
99
+ }