mcp4openapi 0.3.0 → 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 (81) hide show
  1. package/README.md +7 -0
  2. package/dist/src/auth/oauth-provider.d.ts.map +1 -1
  3. package/dist/src/auth/oauth-provider.js +5 -2
  4. package/dist/src/auth/oauth-provider.js.map +1 -1
  5. package/dist/src/core/cli-config.d.ts.map +1 -1
  6. package/dist/src/core/cli-config.js +3 -0
  7. package/dist/src/core/cli-config.js.map +1 -1
  8. package/dist/src/core/index.d.ts.map +1 -1
  9. package/dist/src/core/index.js +19 -3
  10. package/dist/src/core/index.js.map +1 -1
  11. package/dist/src/generated-schemas.d.ts +45 -0
  12. package/dist/src/generated-schemas.d.ts.map +1 -1
  13. package/dist/src/generated-schemas.js +3 -0
  14. package/dist/src/generated-schemas.js.map +1 -1
  15. package/dist/src/openapi/openapi-parser.d.ts.map +1 -1
  16. package/dist/src/openapi/openapi-parser.js +22 -0
  17. package/dist/src/openapi/openapi-parser.js.map +1 -1
  18. package/dist/src/profile/profile-allowlist.d.ts +18 -0
  19. package/dist/src/profile/profile-allowlist.d.ts.map +1 -0
  20. package/dist/src/profile/profile-allowlist.js +68 -0
  21. package/dist/src/profile/profile-allowlist.js.map +1 -0
  22. package/dist/src/profile/profile-loader.d.ts.map +1 -1
  23. package/dist/src/profile/profile-loader.js +8 -1
  24. package/dist/src/profile/profile-loader.js.map +1 -1
  25. package/dist/src/profile/profile-registry.d.ts +7 -1
  26. package/dist/src/profile/profile-registry.d.ts.map +1 -1
  27. package/dist/src/profile/profile-registry.js +49 -8
  28. package/dist/src/profile/profile-registry.js.map +1 -1
  29. package/dist/src/profile/profile-resolver.d.ts +16 -0
  30. package/dist/src/profile/profile-resolver.d.ts.map +1 -1
  31. package/dist/src/profile/profile-resolver.js +120 -0
  32. package/dist/src/profile/profile-resolver.js.map +1 -1
  33. package/dist/src/tooling/composite-executor.d.ts.map +1 -1
  34. package/dist/src/tooling/composite-executor.js +7 -2
  35. package/dist/src/tooling/composite-executor.js.map +1 -1
  36. package/dist/src/tooling/proxy-executor.d.ts.map +1 -1
  37. package/dist/src/tooling/proxy-executor.js +4 -0
  38. package/dist/src/tooling/proxy-executor.js.map +1 -1
  39. package/dist/src/tooling/tool-generator.d.ts.map +1 -1
  40. package/dist/src/tooling/tool-generator.js +36 -3
  41. package/dist/src/tooling/tool-generator.js.map +1 -1
  42. package/dist/src/transport/http-transport-config.d.ts.map +1 -1
  43. package/dist/src/transport/http-transport-config.js +1 -0
  44. package/dist/src/transport/http-transport-config.js.map +1 -1
  45. package/dist/src/transport/http-transport.d.ts +5 -0
  46. package/dist/src/transport/http-transport.d.ts.map +1 -1
  47. package/dist/src/transport/http-transport.js +63 -1
  48. package/dist/src/transport/http-transport.js.map +1 -1
  49. package/dist/src/transport/profile-index.d.ts +84 -0
  50. package/dist/src/transport/profile-index.d.ts.map +1 -0
  51. package/dist/src/transport/profile-index.js +405 -0
  52. package/dist/src/transport/profile-index.js.map +1 -0
  53. package/dist/src/types/http-transport.d.ts +1 -0
  54. package/dist/src/types/http-transport.d.ts.map +1 -1
  55. package/dist/src/types/openapi.d.ts +3 -0
  56. package/dist/src/types/openapi.d.ts.map +1 -1
  57. package/dist/src/types/profile.d.ts +3 -0
  58. package/dist/src/types/profile.d.ts.map +1 -1
  59. package/dist/src/validation/validation-utils.d.ts.map +1 -1
  60. package/dist/src/validation/validation-utils.js +1 -0
  61. package/dist/src/validation/validation-utils.js.map +1 -1
  62. package/html/profile-index.html +386 -0
  63. package/package.json +3 -2
  64. package/profile-schema.json +14 -0
  65. package/profiles/gitlab/developer-profile-oauth.json +244 -42
  66. package/profiles/gitlab/developer-profile-oauth.test.json +1009 -5
  67. package/profiles/gitlab/openapi.yaml +1419 -164
  68. package/profiles/gitlab/profile-optimized-oauth.json +785 -0
  69. package/profiles/gitlab/profile-optimized-oauth.test.json +1566 -0
  70. package/profiles/grafana/openapi.json +28078 -0
  71. package/profiles/grafana/profile.json +1083 -0
  72. package/profiles/grafana/profile.test.json +235 -0
  73. package/profiles/mattermost/openapi.yaml +27434 -0
  74. package/profiles/mattermost/profile.json +463 -0
  75. package/profiles/mattermost/profile.test.json +607 -0
  76. package/profiles/n8n/profile-optimized.json +1002 -364
  77. package/profiles/n8n/profile-optimized.test.json +43 -43
  78. package/profiles/n8n/profile.json +1 -1
  79. package/profiles/n8n-nodes/profile-nodes.json +1 -1
  80. package/profiles/semgrep/profile.json +1 -1
  81. package/profiles/youtrack/profile.json +1 -1
@@ -0,0 +1,1083 @@
1
+ {
2
+ "$schema": "../../profile-schema.json",
3
+ "profile_name": "grafana-optimized",
4
+ "profile_id": "grafana",
5
+ "profile_aliases": ["grafana-optimized"],
6
+ "openapi_spec_path": "./openapi.json",
7
+ "description": "CRUD-oriented tools for core Grafana resources (dashboards, folders, datasources, annotations, snapshots, users, teams, service accounts, search).",
8
+
9
+ "parameter_aliases": {
10
+ "uid": ["dashboard_uid", "datasource_uid", "folder_uid", "public_dashboard_uid"],
11
+ "dashboardUid": ["dashboard_uid"],
12
+ "folder_uid": ["folderUid"],
13
+ "folder_id": ["folderId"],
14
+ "DashboardID": ["dashboard_id"],
15
+ "DashboardVersionID": ["dashboard_version_id"],
16
+ "annotation_id": ["annotationId"],
17
+ "serviceAccountId": ["service_account_id"],
18
+ "tokenId": ["token_id"],
19
+ "team_id": ["teamId"],
20
+ "user_id": ["userId"],
21
+ "datasource_proxy_route": ["proxy_route"],
22
+ "accessToken": ["access_token"],
23
+ "sourceUID": ["source_uid"],
24
+ "correlationUID": ["correlation_uid"],
25
+ "panelId": ["panel_id"],
26
+ "perpage": ["per_page"],
27
+ "Disabled": ["disabled"],
28
+ "dashboardUID": ["dashboard_uid"],
29
+ "dashboardId": ["dashboard_id"],
30
+ "folderUIDs": ["folder_uids"],
31
+ "dashboardUIDs": ["dashboard_uids"]
32
+ },
33
+
34
+ "tools": [
35
+ {
36
+ "name": "create_content",
37
+ "description": "Create Grafana resources. Actions: 'create_dashboard', 'import_dashboard', 'create_folder', 'create_datasource', 'create_annotation', 'create_graphite_annotation', 'create_snapshot', 'create_service_account', 'create_service_account_token', 'create_team', 'add_team_member', 'create_public_dashboard', 'create_correlation'.",
38
+ "metadata_params": ["action"],
39
+ "operations": {
40
+ "create_dashboard": "postDashboard",
41
+ "import_dashboard": "importDashboard",
42
+ "create_folder": "createFolder",
43
+ "create_datasource": "addDataSource",
44
+ "create_annotation": "postAnnotation",
45
+ "create_graphite_annotation": "postGraphiteAnnotation",
46
+ "create_snapshot": "createDashboardSnapshot",
47
+ "create_service_account": "createServiceAccount",
48
+ "create_service_account_token": "createToken",
49
+ "create_team": "createTeam",
50
+ "add_team_member": "addTeamMember",
51
+ "create_public_dashboard": "createPublicDashboard",
52
+ "create_correlation": "createCorrelation"
53
+ },
54
+ "parameters": {
55
+ "action": {
56
+ "type": "string",
57
+ "enum": ["create_dashboard", "import_dashboard", "create_folder", "create_datasource", "create_annotation", "create_graphite_annotation", "create_snapshot", "create_service_account", "create_service_account_token", "create_team", "add_team_member", "create_public_dashboard", "create_correlation"],
58
+ "description": "Action to perform",
59
+ "required": true
60
+ },
61
+ "dashboard": {
62
+ "type": "object",
63
+ "description": "Dashboard definition (Grafana JSON).",
64
+ "required_for": ["create_dashboard", "import_dashboard"],
65
+ "properties": {}
66
+ },
67
+ "folderUid": {
68
+ "type": "string",
69
+ "description": "Target folder UID",
70
+ "required_for": []
71
+ },
72
+ "folderId": {
73
+ "type": "integer",
74
+ "description": "Deprecated: use folderUid",
75
+ "required_for": []
76
+ },
77
+ "overwrite": {
78
+ "type": "boolean",
79
+ "description": "Overwrite existing dashboard/folder",
80
+ "required_for": []
81
+ },
82
+ "message": {
83
+ "type": "string",
84
+ "description": "Commit message for dashboard update",
85
+ "required_for": []
86
+ },
87
+ "isFolder": {
88
+ "type": "boolean",
89
+ "description": "Create folder instead of dashboard",
90
+ "required_for": []
91
+ },
92
+ "inputs": {
93
+ "type": "array",
94
+ "description": "Import inputs (for import_dashboard)",
95
+ "items": { "type": "object", "properties": {} },
96
+ "required_for": []
97
+ },
98
+ "path": {
99
+ "type": "string",
100
+ "description": "Dashboard path (for import_dashboard)",
101
+ "required_for": []
102
+ },
103
+ "pluginId": {
104
+ "type": "string",
105
+ "description": "Plugin ID (for import_dashboard)",
106
+ "required_for": []
107
+ },
108
+ "title": {
109
+ "type": "string",
110
+ "description": "Folder title",
111
+ "required_for": ["create_folder"]
112
+ },
113
+ "description": {
114
+ "type": "string",
115
+ "description": "Folder or correlation description",
116
+ "required_for": []
117
+ },
118
+ "uid": {
119
+ "type": "string",
120
+ "description": "Resource UID",
121
+ "required_for": []
122
+ },
123
+ "parentUid": {
124
+ "type": "string",
125
+ "description": "Parent folder UID",
126
+ "required_for": []
127
+ },
128
+ "name": {
129
+ "type": "string",
130
+ "description": "Name for datasources, service accounts, tokens, teams, snapshots",
131
+ "required_for": ["create_datasource", "create_service_account", "create_service_account_token", "create_team"]
132
+ },
133
+ "type": {
134
+ "type": "string",
135
+ "description": "Datasource or correlation type",
136
+ "required_for": ["create_datasource", "create_correlation"]
137
+ },
138
+ "url": {
139
+ "type": "string",
140
+ "description": "Datasource URL",
141
+ "required_for": []
142
+ },
143
+ "access": {
144
+ "type": "string",
145
+ "description": "Datasource access mode",
146
+ "required_for": []
147
+ },
148
+ "basicAuth": {
149
+ "type": "boolean",
150
+ "description": "Enable basic auth",
151
+ "required_for": []
152
+ },
153
+ "basicAuthUser": {
154
+ "type": "string",
155
+ "description": "Basic auth user",
156
+ "required_for": []
157
+ },
158
+ "database": {
159
+ "type": "string",
160
+ "description": "Datasource database",
161
+ "required_for": []
162
+ },
163
+ "isDefault": {
164
+ "type": "boolean",
165
+ "description": "Make datasource default",
166
+ "required_for": []
167
+ },
168
+ "jsonData": {
169
+ "type": "object",
170
+ "description": "Datasource JSON config",
171
+ "required_for": [],
172
+ "properties": {}
173
+ },
174
+ "secureJsonData": {
175
+ "type": "object",
176
+ "description": "Datasource secure JSON config",
177
+ "required_for": [],
178
+ "properties": {}
179
+ },
180
+ "user": {
181
+ "type": "string",
182
+ "description": "Datasource user",
183
+ "required_for": []
184
+ },
185
+ "withCredentials": {
186
+ "type": "boolean",
187
+ "description": "Use credentials for datasource",
188
+ "required_for": []
189
+ },
190
+ "dashboardId": {
191
+ "type": "integer",
192
+ "description": "Dashboard ID for annotations",
193
+ "required_for": []
194
+ },
195
+ "dashboardUID": {
196
+ "type": "string",
197
+ "description": "Dashboard UID for annotations",
198
+ "required_for": []
199
+ },
200
+ "panelId": {
201
+ "type": "integer",
202
+ "description": "Panel ID for annotations",
203
+ "required_for": []
204
+ },
205
+ "tags": {
206
+ "type": "array",
207
+ "description": "Annotation tags",
208
+ "items": { "type": "string" },
209
+ "required_for": []
210
+ },
211
+ "text": {
212
+ "type": "string",
213
+ "description": "Annotation text",
214
+ "required_for": ["create_annotation"]
215
+ },
216
+ "time": {
217
+ "type": "integer",
218
+ "description": "Annotation start time (ms)",
219
+ "required_for": []
220
+ },
221
+ "timeEnd": {
222
+ "type": "integer",
223
+ "description": "Annotation end time (ms)",
224
+ "required_for": []
225
+ },
226
+ "data": {
227
+ "type": "object",
228
+ "description": "Annotation data payload",
229
+ "required_for": [],
230
+ "properties": {}
231
+ },
232
+ "what": {
233
+ "type": "string",
234
+ "description": "Graphite annotation title",
235
+ "required_for": ["create_graphite_annotation"]
236
+ },
237
+ "when": {
238
+ "type": "integer",
239
+ "description": "Graphite annotation timestamp (ms)",
240
+ "required_for": ["create_graphite_annotation"]
241
+ },
242
+ "apiVersion": {
243
+ "type": "string",
244
+ "description": "Snapshot API version",
245
+ "required_for": []
246
+ },
247
+ "kind": {
248
+ "type": "string",
249
+ "description": "Snapshot kind",
250
+ "required_for": []
251
+ },
252
+ "expires": {
253
+ "type": "integer",
254
+ "description": "Snapshot expiration in seconds",
255
+ "required_for": []
256
+ },
257
+ "external": {
258
+ "type": "boolean",
259
+ "description": "Store snapshot externally",
260
+ "required_for": []
261
+ },
262
+ "key": {
263
+ "type": "string",
264
+ "description": "Snapshot key",
265
+ "required_for": []
266
+ },
267
+ "deleteKey": {
268
+ "type": "string",
269
+ "description": "Snapshot delete key",
270
+ "required_for": []
271
+ },
272
+ "role": {
273
+ "type": "string",
274
+ "description": "Service account role (Viewer, Editor, Admin)",
275
+ "required_for": ["create_service_account"]
276
+ },
277
+ "isDisabled": {
278
+ "type": "boolean",
279
+ "description": "Disable service account",
280
+ "required_for": []
281
+ },
282
+ "secondsToLive": {
283
+ "type": "integer",
284
+ "description": "Token TTL in seconds",
285
+ "required_for": []
286
+ },
287
+ "email": {
288
+ "type": "string",
289
+ "description": "Team email",
290
+ "required_for": []
291
+ },
292
+ "userId": {
293
+ "type": "integer",
294
+ "description": "User ID for team membership",
295
+ "required_for": ["add_team_member"]
296
+ },
297
+ "accessToken": {
298
+ "type": "string",
299
+ "description": "Public dashboard access token",
300
+ "required_for": []
301
+ },
302
+ "annotationsEnabled": {
303
+ "type": "boolean",
304
+ "description": "Enable public annotations",
305
+ "required_for": []
306
+ },
307
+ "isEnabled": {
308
+ "type": "boolean",
309
+ "description": "Enable public dashboard",
310
+ "required_for": []
311
+ },
312
+ "share": {
313
+ "type": "string",
314
+ "description": "Public dashboard share type",
315
+ "required_for": []
316
+ },
317
+ "timeSelectionEnabled": {
318
+ "type": "boolean",
319
+ "description": "Enable time selection",
320
+ "required_for": []
321
+ },
322
+ "label": {
323
+ "type": "string",
324
+ "description": "Correlation label",
325
+ "required_for": []
326
+ },
327
+ "targetUID": {
328
+ "type": "string",
329
+ "description": "Target data source UID for correlation",
330
+ "required_for": []
331
+ },
332
+ "config": {
333
+ "type": "object",
334
+ "description": "Correlation config",
335
+ "required_for": [],
336
+ "properties": {}
337
+ }
338
+ }
339
+ },
340
+
341
+ {
342
+ "name": "retrieve_content",
343
+ "description": "Retrieve Grafana resources. Actions: 'search', 'list_dashboards_tags', 'get_dashboard_home', 'get_dashboard_by_uid', 'get_dashboard_versions_by_uid', 'get_dashboard_version_by_uid', 'list_public_dashboards', 'get_public_dashboard', 'view_public_dashboard', 'get_public_annotations', 'list_folders', 'get_folder_by_uid', 'get_folder_by_id', 'get_folder_counts', 'list_datasources', 'get_datasource_by_id', 'get_datasource_by_uid', 'get_datasource_by_name', 'get_datasource_id_by_name', 'check_datasource_health_by_id', 'check_datasource_health_by_uid', 'get_datasource_resource_by_id', 'get_datasource_resource_by_uid', 'query_metrics', 'get_annotations', 'get_annotation_by_id', 'get_annotation_tags', 'get_snapshot', 'search_snapshots', 'get_snapshot_sharing_options', 'list_service_accounts', 'get_service_account', 'list_service_account_tokens', 'search_users', 'search_users_paged', 'get_user_by_id', 'get_user_by_login_or_email', 'get_user_orgs', 'get_user_teams', 'search_teams', 'get_team_by_id', 'list_team_members', 'get_team_preferences', 'get_dashboard_permissions_by_uid', 'get_dashboard_permissions_by_id', 'get_folder_permissions', 'get_correlations', 'get_correlations_by_source_uid', 'get_correlation'.",
344
+ "metadata_params": ["action"],
345
+ "operations": {
346
+ "search": "search",
347
+ "list_dashboards_tags": "getDashboardTags",
348
+ "get_dashboard_home": "getHomeDashboard",
349
+ "get_dashboard_by_uid": "getDashboardByUID",
350
+ "get_dashboard_versions_by_uid": "getDashboardVersionsByUID",
351
+ "get_dashboard_version_by_uid": "getDashboardVersionByUID",
352
+ "list_public_dashboards": "listPublicDashboards",
353
+ "get_public_dashboard": "getPublicDashboard",
354
+ "view_public_dashboard": "viewPublicDashboard",
355
+ "get_public_annotations": "getPublicAnnotations",
356
+ "list_folders": "getFolders",
357
+ "get_folder_by_uid": "getFolderByUID",
358
+ "get_folder_by_id": "getFolderByID",
359
+ "get_folder_counts": "getFolderDescendantCounts",
360
+ "list_datasources": "getDataSources",
361
+ "get_datasource_by_id": "getDataSourceByID",
362
+ "get_datasource_by_uid": "getDataSourceByUID",
363
+ "get_datasource_by_name": "getDataSourceByName",
364
+ "get_datasource_id_by_name": "getDataSourceIdByName",
365
+ "check_datasource_health_by_id": "checkDatasourceHealthByID",
366
+ "check_datasource_health_by_uid": "checkDatasourceHealthWithUID",
367
+ "get_datasource_resource_by_id": "callDatasourceResourceByID",
368
+ "get_datasource_resource_by_uid": "callDatasourceResourceWithUID",
369
+ "query_metrics": "queryMetricsWithExpressions",
370
+ "get_annotations": "getAnnotations",
371
+ "get_annotation_by_id": "getAnnotationByID",
372
+ "get_annotation_tags": "getAnnotationTags",
373
+ "get_snapshot": "getDashboardSnapshot",
374
+ "search_snapshots": "searchDashboardSnapshots",
375
+ "get_snapshot_sharing_options": "getSharingOptions",
376
+ "list_service_accounts": "searchOrgServiceAccountsWithPaging",
377
+ "get_service_account": "retrieveServiceAccount",
378
+ "list_service_account_tokens": "listTokens",
379
+ "search_users": "searchUsers",
380
+ "search_users_paged": "searchUsersWithPaging",
381
+ "get_user_by_id": "getUserByID",
382
+ "get_user_by_login_or_email": "getUserByLoginOrEmail",
383
+ "get_user_orgs": "getUserOrgList",
384
+ "get_user_teams": "getUserTeams",
385
+ "search_teams": "searchTeams",
386
+ "get_team_by_id": "getTeamByID",
387
+ "list_team_members": "getTeamMembers",
388
+ "get_team_preferences": "getTeamPreferences",
389
+ "get_dashboard_permissions_by_uid": "getDashboardPermissionsListByUID",
390
+ "get_dashboard_permissions_by_id": "getDashboardPermissionsListByID",
391
+ "get_folder_permissions": "getFolderPermissionList",
392
+ "get_correlations": "getCorrelations",
393
+ "get_correlations_by_source_uid": "getCorrelationsBySourceUID",
394
+ "get_correlation": "getCorrelation"
395
+ },
396
+ "parameters": {
397
+ "action": {
398
+ "type": "string",
399
+ "enum": ["search", "list_dashboards_tags", "get_dashboard_home", "get_dashboard_by_uid", "get_dashboard_versions_by_uid", "get_dashboard_version_by_uid", "list_public_dashboards", "get_public_dashboard", "view_public_dashboard", "get_public_annotations", "list_folders", "get_folder_by_uid", "get_folder_by_id", "get_folder_counts", "list_datasources", "get_datasource_by_id", "get_datasource_by_uid", "get_datasource_by_name", "get_datasource_id_by_name", "check_datasource_health_by_id", "check_datasource_health_by_uid", "get_datasource_resource_by_id", "get_datasource_resource_by_uid", "query_metrics", "get_annotations", "get_annotation_by_id", "get_annotation_tags", "get_snapshot", "search_snapshots", "get_snapshot_sharing_options", "list_service_accounts", "get_service_account", "list_service_account_tokens", "search_users", "search_users_paged", "get_user_by_id", "get_user_by_login_or_email", "get_user_orgs", "get_user_teams", "search_teams", "get_team_by_id", "list_team_members", "get_team_preferences", "get_dashboard_permissions_by_uid", "get_dashboard_permissions_by_id", "get_folder_permissions", "get_correlations", "get_correlations_by_source_uid", "get_correlation"],
400
+ "description": "Action to perform",
401
+ "required": true
402
+ },
403
+ "uid": {
404
+ "type": "string",
405
+ "description": "Resource UID",
406
+ "required_for": ["get_dashboard_by_uid", "get_dashboard_versions_by_uid", "get_dashboard_version_by_uid", "get_folder_by_uid", "get_folder_counts", "get_datasource_by_uid", "check_datasource_health_by_uid", "get_datasource_resource_by_uid", "get_dashboard_permissions_by_uid"]
407
+ },
408
+ "dashboardUid": {
409
+ "type": "string",
410
+ "description": "Dashboard UID",
411
+ "required_for": ["get_public_dashboard"]
412
+ },
413
+ "folder_uid": {
414
+ "type": "string",
415
+ "description": "Folder UID",
416
+ "required_for": ["get_folder_permissions"]
417
+ },
418
+ "folder_id": {
419
+ "type": "string",
420
+ "description": "Folder ID",
421
+ "required_for": ["get_folder_by_id"]
422
+ },
423
+ "DashboardID": {
424
+ "type": "string",
425
+ "description": "Dashboard ID",
426
+ "required_for": ["get_dashboard_permissions_by_id"]
427
+ },
428
+ "DashboardVersionID": {
429
+ "type": "string",
430
+ "description": "Dashboard version ID",
431
+ "required_for": ["get_dashboard_version_by_uid"]
432
+ },
433
+ "annotation_id": {
434
+ "type": "string",
435
+ "description": "Annotation ID",
436
+ "required_for": ["get_annotation_by_id"]
437
+ },
438
+ "id": {
439
+ "type": "string",
440
+ "description": "Datasource ID",
441
+ "required_for": ["get_datasource_by_id", "check_datasource_health_by_id", "get_datasource_resource_by_id"]
442
+ },
443
+ "name": {
444
+ "type": "string",
445
+ "description": "Datasource name",
446
+ "required_for": ["get_datasource_by_name", "get_datasource_id_by_name"]
447
+ },
448
+ "key": {
449
+ "type": "string",
450
+ "description": "Snapshot key",
451
+ "required_for": ["get_snapshot"]
452
+ },
453
+ "serviceAccountId": {
454
+ "type": "string",
455
+ "description": "Service account ID",
456
+ "required_for": ["get_service_account", "list_service_account_tokens"]
457
+ },
458
+ "user_id": {
459
+ "type": "string",
460
+ "description": "User ID",
461
+ "required_for": ["get_user_by_id", "get_user_orgs", "get_user_teams"]
462
+ },
463
+ "team_id": {
464
+ "type": "string",
465
+ "description": "Team ID",
466
+ "required_for": ["get_team_by_id", "list_team_members", "get_team_preferences"]
467
+ },
468
+ "accessToken": {
469
+ "type": "string",
470
+ "description": "Public dashboard access token",
471
+ "required_for": ["view_public_dashboard", "get_public_annotations"]
472
+ },
473
+ "datasource_proxy_route": {
474
+ "type": "string",
475
+ "description": "Datasource proxy route",
476
+ "required_for": ["get_datasource_resource_by_id", "get_datasource_resource_by_uid"]
477
+ },
478
+ "sourceUID": {
479
+ "type": "string",
480
+ "description": "Source datasource UID for correlations",
481
+ "required_for": ["get_correlations_by_source_uid", "get_correlation"]
482
+ },
483
+ "correlationUID": {
484
+ "type": "string",
485
+ "description": "Correlation UID",
486
+ "required_for": ["get_correlation"]
487
+ },
488
+ "query": {
489
+ "type": "string",
490
+ "description": "Search query",
491
+ "required_for": []
492
+ },
493
+ "tag": {
494
+ "type": "string",
495
+ "description": "Search tag",
496
+ "required_for": []
497
+ },
498
+ "type": {
499
+ "type": "string",
500
+ "description": "Search type",
501
+ "required_for": []
502
+ },
503
+ "dashboardIds": {
504
+ "type": "string",
505
+ "description": "Dashboard IDs (comma-separated)",
506
+ "required_for": []
507
+ },
508
+ "dashboardUIDs": {
509
+ "type": "string",
510
+ "description": "Dashboard UIDs (comma-separated)",
511
+ "required_for": []
512
+ },
513
+ "folderIds": {
514
+ "type": "string",
515
+ "description": "Folder IDs (comma-separated)",
516
+ "required_for": []
517
+ },
518
+ "folderUIDs": {
519
+ "type": "string",
520
+ "description": "Folder UIDs (comma-separated)",
521
+ "required_for": []
522
+ },
523
+ "starred": {
524
+ "type": "boolean",
525
+ "description": "Only starred dashboards",
526
+ "required_for": []
527
+ },
528
+ "limit": {
529
+ "type": "integer",
530
+ "description": "Limit results",
531
+ "required_for": []
532
+ },
533
+ "page": {
534
+ "type": "integer",
535
+ "description": "Page number",
536
+ "required_for": []
537
+ },
538
+ "perpage": {
539
+ "type": "integer",
540
+ "description": "Items per page",
541
+ "required_for": []
542
+ },
543
+ "permission": {
544
+ "type": "string",
545
+ "description": "Permission filter",
546
+ "required_for": []
547
+ },
548
+ "sort": {
549
+ "type": "string",
550
+ "description": "Sort option",
551
+ "required_for": []
552
+ },
553
+ "deleted": {
554
+ "type": "boolean",
555
+ "description": "Include deleted items",
556
+ "required_for": []
557
+ },
558
+ "from": {
559
+ "type": "integer",
560
+ "description": "Annotations start time (ms)",
561
+ "required_for": []
562
+ },
563
+ "to": {
564
+ "type": "integer",
565
+ "description": "Annotations end time (ms)",
566
+ "required_for": []
567
+ },
568
+ "userId": {
569
+ "type": "integer",
570
+ "description": "Annotation user ID",
571
+ "required_for": []
572
+ },
573
+ "alertId": {
574
+ "type": "integer",
575
+ "description": "Annotation alert ID",
576
+ "required_for": []
577
+ },
578
+ "alertUID": {
579
+ "type": "string",
580
+ "description": "Annotation alert UID",
581
+ "required_for": []
582
+ },
583
+ "dashboardId": {
584
+ "type": "integer",
585
+ "description": "Annotation dashboard ID",
586
+ "required_for": []
587
+ },
588
+ "dashboardUID": {
589
+ "type": "string",
590
+ "description": "Annotation dashboard UID",
591
+ "required_for": []
592
+ },
593
+ "panelId": {
594
+ "type": "integer",
595
+ "description": "Annotation panel ID",
596
+ "required_for": []
597
+ },
598
+ "tags": {
599
+ "type": "string",
600
+ "description": "Annotation tags",
601
+ "required_for": []
602
+ },
603
+ "matchAny": {
604
+ "type": "boolean",
605
+ "description": "Match any tag",
606
+ "required_for": []
607
+ },
608
+ "Disabled": {
609
+ "type": "boolean",
610
+ "description": "Include disabled service accounts",
611
+ "required_for": []
612
+ },
613
+ "expiredTokens": {
614
+ "type": "boolean",
615
+ "description": "Include expired tokens",
616
+ "required_for": []
617
+ },
618
+ "start": {
619
+ "type": "integer",
620
+ "description": "Pagination start offset",
621
+ "required_for": []
622
+ }
623
+ }
624
+ },
625
+
626
+ {
627
+ "name": "update_content",
628
+ "description": "Update Grafana resources. Actions: 'update_dashboard', 'update_folder', 'move_folder', 'update_folder_permissions', 'update_datasource_by_id', 'update_datasource_by_uid', 'update_annotation', 'patch_annotation', 'update_service_account', 'update_team', 'set_team_memberships', 'update_team_member', 'update_team_preferences', 'update_user', 'update_public_dashboard', 'update_dashboard_permissions_by_uid', 'update_dashboard_permissions_by_id', 'restore_dashboard_version', 'update_correlation'.",
629
+ "metadata_params": ["action"],
630
+ "operations": {
631
+ "update_dashboard": "postDashboard",
632
+ "update_folder": "updateFolder",
633
+ "move_folder": "moveFolder",
634
+ "update_folder_permissions": "updateFolderPermissions",
635
+ "update_datasource_by_id": "updateDataSourceByID",
636
+ "update_datasource_by_uid": "updateDataSourceByUID",
637
+ "update_annotation": "updateAnnotation",
638
+ "patch_annotation": "patchAnnotation",
639
+ "update_service_account": "updateServiceAccount",
640
+ "update_team": "updateTeam",
641
+ "set_team_memberships": "setTeamMemberships",
642
+ "update_team_member": "updateTeamMember",
643
+ "update_team_preferences": "updateTeamPreferences",
644
+ "update_user": "updateUser",
645
+ "update_public_dashboard": "updatePublicDashboard",
646
+ "update_dashboard_permissions_by_uid": "updateDashboardPermissionsByUID",
647
+ "update_dashboard_permissions_by_id": "updateDashboardPermissionsByID",
648
+ "restore_dashboard_version": "restoreDashboardVersionByUID",
649
+ "update_correlation": "updateCorrelation"
650
+ },
651
+ "parameters": {
652
+ "action": {
653
+ "type": "string",
654
+ "enum": ["update_dashboard", "update_folder", "move_folder", "update_folder_permissions", "update_datasource_by_id", "update_datasource_by_uid", "update_annotation", "patch_annotation", "update_service_account", "update_team", "set_team_memberships", "update_team_member", "update_team_preferences", "update_user", "update_public_dashboard", "update_dashboard_permissions_by_uid", "update_dashboard_permissions_by_id", "restore_dashboard_version", "update_correlation"],
655
+ "description": "Action to perform",
656
+ "required": true
657
+ },
658
+ "uid": {
659
+ "type": "string",
660
+ "description": "Dashboard or datasource UID",
661
+ "required_for": ["update_datasource_by_uid", "update_public_dashboard", "update_dashboard_permissions_by_uid", "restore_dashboard_version"]
662
+ },
663
+ "dashboardUid": {
664
+ "type": "string",
665
+ "description": "Dashboard UID for public dashboard update",
666
+ "required_for": ["update_public_dashboard"]
667
+ },
668
+ "folder_uid": {
669
+ "type": "string",
670
+ "description": "Folder UID",
671
+ "required_for": ["update_folder", "move_folder", "update_folder_permissions"]
672
+ },
673
+ "DashboardID": {
674
+ "type": "string",
675
+ "description": "Dashboard ID",
676
+ "required_for": ["update_dashboard_permissions_by_id"]
677
+ },
678
+ "annotation_id": {
679
+ "type": "string",
680
+ "description": "Annotation ID",
681
+ "required_for": ["update_annotation", "patch_annotation"]
682
+ },
683
+ "id": {
684
+ "type": "string",
685
+ "description": "Datasource ID",
686
+ "required_for": ["update_datasource_by_id"]
687
+ },
688
+ "serviceAccountId": {
689
+ "type": "string",
690
+ "description": "Service account ID",
691
+ "required_for": ["update_service_account"]
692
+ },
693
+ "team_id": {
694
+ "type": "string",
695
+ "description": "Team ID",
696
+ "required_for": ["update_team", "set_team_memberships", "update_team_member", "update_team_preferences"]
697
+ },
698
+ "user_id": {
699
+ "type": "string",
700
+ "description": "User ID",
701
+ "required_for": ["update_team_member", "update_user"]
702
+ },
703
+ "sourceUID": {
704
+ "type": "string",
705
+ "description": "Source datasource UID for correlation",
706
+ "required_for": ["update_correlation"]
707
+ },
708
+ "correlationUID": {
709
+ "type": "string",
710
+ "description": "Correlation UID",
711
+ "required_for": ["update_correlation"]
712
+ },
713
+ "dashboard": {
714
+ "type": "object",
715
+ "description": "Dashboard definition (Grafana JSON)",
716
+ "required_for": ["update_dashboard"],
717
+ "properties": {}
718
+ },
719
+ "folderUid": {
720
+ "type": "string",
721
+ "description": "Target folder UID",
722
+ "required_for": []
723
+ },
724
+ "folderId": {
725
+ "type": "integer",
726
+ "description": "Deprecated: use folderUid",
727
+ "required_for": []
728
+ },
729
+ "overwrite": {
730
+ "type": "boolean",
731
+ "description": "Overwrite existing dashboard/folder",
732
+ "required_for": []
733
+ },
734
+ "message": {
735
+ "type": "string",
736
+ "description": "Commit message for dashboard update",
737
+ "required_for": []
738
+ },
739
+ "title": {
740
+ "type": "string",
741
+ "description": "Folder title",
742
+ "required_for": []
743
+ },
744
+ "description": {
745
+ "type": "string",
746
+ "description": "Folder or correlation description",
747
+ "required_for": []
748
+ },
749
+ "parentUid": {
750
+ "type": "string",
751
+ "description": "Parent folder UID",
752
+ "required_for": ["move_folder"]
753
+ },
754
+ "name": {
755
+ "type": "string",
756
+ "description": "Name for datasources, service accounts, teams",
757
+ "required_for": []
758
+ },
759
+ "type": {
760
+ "type": "string",
761
+ "description": "Datasource or correlation type",
762
+ "required_for": []
763
+ },
764
+ "url": {
765
+ "type": "string",
766
+ "description": "Datasource URL",
767
+ "required_for": []
768
+ },
769
+ "access": {
770
+ "type": "string",
771
+ "description": "Datasource access mode",
772
+ "required_for": []
773
+ },
774
+ "basicAuth": {
775
+ "type": "boolean",
776
+ "description": "Enable basic auth",
777
+ "required_for": []
778
+ },
779
+ "basicAuthUser": {
780
+ "type": "string",
781
+ "description": "Basic auth user",
782
+ "required_for": []
783
+ },
784
+ "database": {
785
+ "type": "string",
786
+ "description": "Datasource database",
787
+ "required_for": []
788
+ },
789
+ "isDefault": {
790
+ "type": "boolean",
791
+ "description": "Make datasource default",
792
+ "required_for": []
793
+ },
794
+ "jsonData": {
795
+ "type": "object",
796
+ "description": "Datasource JSON config",
797
+ "required_for": [],
798
+ "properties": {}
799
+ },
800
+ "secureJsonData": {
801
+ "type": "object",
802
+ "description": "Datasource secure JSON config",
803
+ "required_for": [],
804
+ "properties": {}
805
+ },
806
+ "user": {
807
+ "type": "string",
808
+ "description": "Datasource user",
809
+ "required_for": []
810
+ },
811
+ "withCredentials": {
812
+ "type": "boolean",
813
+ "description": "Use credentials for datasource",
814
+ "required_for": []
815
+ },
816
+ "version": {
817
+ "type": "integer",
818
+ "description": "Optimistic locking version",
819
+ "required_for": []
820
+ },
821
+ "text": {
822
+ "type": "string",
823
+ "description": "Annotation text",
824
+ "required_for": []
825
+ },
826
+ "tags": {
827
+ "type": "array",
828
+ "description": "Annotation tags",
829
+ "items": { "type": "string" },
830
+ "required_for": []
831
+ },
832
+ "time": {
833
+ "type": "integer",
834
+ "description": "Annotation start time (ms)",
835
+ "required_for": []
836
+ },
837
+ "timeEnd": {
838
+ "type": "integer",
839
+ "description": "Annotation end time (ms)",
840
+ "required_for": []
841
+ },
842
+ "data": {
843
+ "type": "object",
844
+ "description": "Annotation data payload",
845
+ "required_for": [],
846
+ "properties": {}
847
+ },
848
+ "role": {
849
+ "type": "string",
850
+ "description": "Service account role",
851
+ "required_for": []
852
+ },
853
+ "isDisabled": {
854
+ "type": "boolean",
855
+ "description": "Disable service account",
856
+ "required_for": []
857
+ },
858
+ "email": {
859
+ "type": "string",
860
+ "description": "Team email",
861
+ "required_for": []
862
+ },
863
+ "admins": {
864
+ "type": "array",
865
+ "description": "Team admin user IDs",
866
+ "items": { "type": "string" },
867
+ "required_for": []
868
+ },
869
+ "members": {
870
+ "type": "array",
871
+ "description": "Team member user IDs",
872
+ "items": { "type": "string" },
873
+ "required_for": []
874
+ },
875
+ "permission": {
876
+ "type": "string",
877
+ "description": "Team member permission",
878
+ "required_for": []
879
+ },
880
+ "homeDashboardId": {
881
+ "type": "integer",
882
+ "description": "Home dashboard ID for preferences",
883
+ "required_for": []
884
+ },
885
+ "homeDashboardUID": {
886
+ "type": "string",
887
+ "description": "Home dashboard UID for preferences",
888
+ "required_for": []
889
+ },
890
+ "language": {
891
+ "type": "string",
892
+ "description": "Preferred language",
893
+ "required_for": []
894
+ },
895
+ "regionalFormat": {
896
+ "type": "string",
897
+ "description": "Regional format",
898
+ "required_for": []
899
+ },
900
+ "theme": {
901
+ "type": "string",
902
+ "description": "Theme (light, dark, system)",
903
+ "required_for": []
904
+ },
905
+ "timezone": {
906
+ "type": "string",
907
+ "description": "Timezone",
908
+ "required_for": []
909
+ },
910
+ "weekStart": {
911
+ "type": "string",
912
+ "description": "Week start",
913
+ "required_for": []
914
+ },
915
+ "accessToken": {
916
+ "type": "string",
917
+ "description": "Public dashboard access token",
918
+ "required_for": []
919
+ },
920
+ "annotationsEnabled": {
921
+ "type": "boolean",
922
+ "description": "Enable public annotations",
923
+ "required_for": []
924
+ },
925
+ "isEnabled": {
926
+ "type": "boolean",
927
+ "description": "Enable public dashboard",
928
+ "required_for": []
929
+ },
930
+ "share": {
931
+ "type": "string",
932
+ "description": "Public dashboard share type",
933
+ "required_for": []
934
+ },
935
+ "timeSelectionEnabled": {
936
+ "type": "boolean",
937
+ "description": "Enable time selection",
938
+ "required_for": []
939
+ },
940
+ "items": {
941
+ "type": "array",
942
+ "description": "ACL items for dashboard/folder permissions",
943
+ "items": { "type": "object", "properties": {} },
944
+ "required_for": ["update_dashboard_permissions_by_uid", "update_dashboard_permissions_by_id", "update_folder_permissions"]
945
+ },
946
+ "label": {
947
+ "type": "string",
948
+ "description": "Correlation label",
949
+ "required_for": []
950
+ },
951
+ "targetUID": {
952
+ "type": "string",
953
+ "description": "Target data source UID for correlation",
954
+ "required_for": []
955
+ },
956
+ "config": {
957
+ "type": "object",
958
+ "description": "Correlation config",
959
+ "required_for": [],
960
+ "properties": {}
961
+ }
962
+ }
963
+ },
964
+
965
+ {
966
+ "name": "delete_content",
967
+ "description": "Delete Grafana resources. Actions: 'delete_dashboard', 'delete_folder', 'delete_datasource_by_id', 'delete_datasource_by_uid', 'delete_datasource_by_name', 'delete_annotation', 'delete_snapshot', 'delete_snapshot_by_delete_key', 'delete_service_account', 'delete_service_account_token', 'delete_team', 'remove_team_member', 'delete_public_dashboard', 'delete_correlation', 'delete_datasource_proxy_by_id', 'delete_datasource_proxy_by_uid'.",
968
+ "metadata_params": ["action"],
969
+ "operations": {
970
+ "delete_dashboard": "deleteDashboardByUID",
971
+ "delete_folder": "deleteFolder",
972
+ "delete_datasource_by_id": "deleteDataSourceByID",
973
+ "delete_datasource_by_uid": "deleteDataSourceByUID",
974
+ "delete_datasource_by_name": "deleteDataSourceByName",
975
+ "delete_annotation": "deleteAnnotationByID",
976
+ "delete_snapshot": "deleteDashboardSnapshot",
977
+ "delete_snapshot_by_delete_key": "deleteDashboardSnapshotByDeleteKey",
978
+ "delete_service_account": "deleteServiceAccount",
979
+ "delete_service_account_token": "deleteToken",
980
+ "delete_team": "deleteTeamByID",
981
+ "remove_team_member": "removeTeamMember",
982
+ "delete_public_dashboard": "deletePublicDashboard",
983
+ "delete_correlation": "deleteCorrelation",
984
+ "delete_datasource_proxy_by_id": "datasourceProxyDELETEcalls",
985
+ "delete_datasource_proxy_by_uid": "datasourceProxyDELETEByUIDcalls"
986
+ },
987
+ "parameters": {
988
+ "action": {
989
+ "type": "string",
990
+ "enum": ["delete_dashboard", "delete_folder", "delete_datasource_by_id", "delete_datasource_by_uid", "delete_datasource_by_name", "delete_annotation", "delete_snapshot", "delete_snapshot_by_delete_key", "delete_service_account", "delete_service_account_token", "delete_team", "remove_team_member", "delete_public_dashboard", "delete_correlation", "delete_datasource_proxy_by_id", "delete_datasource_proxy_by_uid"],
991
+ "description": "Action to perform",
992
+ "required": true
993
+ },
994
+ "uid": {
995
+ "type": "string",
996
+ "description": "Dashboard or datasource UID",
997
+ "required_for": ["delete_dashboard", "delete_datasource_by_uid", "delete_public_dashboard", "delete_datasource_proxy_by_uid"]
998
+ },
999
+ "dashboardUid": {
1000
+ "type": "string",
1001
+ "description": "Dashboard UID for public dashboard deletion",
1002
+ "required_for": ["delete_public_dashboard"]
1003
+ },
1004
+ "folder_uid": {
1005
+ "type": "string",
1006
+ "description": "Folder UID",
1007
+ "required_for": ["delete_folder"]
1008
+ },
1009
+ "id": {
1010
+ "type": "string",
1011
+ "description": "Datasource ID",
1012
+ "required_for": ["delete_datasource_by_id", "delete_datasource_proxy_by_id"]
1013
+ },
1014
+ "name": {
1015
+ "type": "string",
1016
+ "description": "Datasource name",
1017
+ "required_for": ["delete_datasource_by_name"]
1018
+ },
1019
+ "annotation_id": {
1020
+ "type": "string",
1021
+ "description": "Annotation ID",
1022
+ "required_for": ["delete_annotation"]
1023
+ },
1024
+ "key": {
1025
+ "type": "string",
1026
+ "description": "Snapshot key",
1027
+ "required_for": ["delete_snapshot"]
1028
+ },
1029
+ "deleteKey": {
1030
+ "type": "string",
1031
+ "description": "Snapshot delete key",
1032
+ "required_for": ["delete_snapshot_by_delete_key"]
1033
+ },
1034
+ "serviceAccountId": {
1035
+ "type": "string",
1036
+ "description": "Service account ID",
1037
+ "required_for": ["delete_service_account", "delete_service_account_token"]
1038
+ },
1039
+ "tokenId": {
1040
+ "type": "string",
1041
+ "description": "Service account token ID",
1042
+ "required_for": ["delete_service_account_token"]
1043
+ },
1044
+ "team_id": {
1045
+ "type": "string",
1046
+ "description": "Team ID",
1047
+ "required_for": ["delete_team", "remove_team_member"]
1048
+ },
1049
+ "user_id": {
1050
+ "type": "string",
1051
+ "description": "User ID",
1052
+ "required_for": ["remove_team_member"]
1053
+ },
1054
+ "sourceUID": {
1055
+ "type": "string",
1056
+ "description": "Source datasource UID for correlation",
1057
+ "required_for": ["delete_correlation"]
1058
+ },
1059
+ "correlationUID": {
1060
+ "type": "string",
1061
+ "description": "Correlation UID",
1062
+ "required_for": ["delete_correlation"]
1063
+ },
1064
+ "datasource_proxy_route": {
1065
+ "type": "string",
1066
+ "description": "Datasource proxy route",
1067
+ "required_for": ["delete_datasource_proxy_by_id", "delete_datasource_proxy_by_uid"]
1068
+ }
1069
+ }
1070
+ }
1071
+ ],
1072
+
1073
+ "interceptors": {
1074
+ "auth": {
1075
+ "type": "bearer",
1076
+ "value_from_env": "GRAFANA_TOKEN"
1077
+ },
1078
+ "base_url": {
1079
+ "value_from_env": "GRAFANA_API_BASE_URL",
1080
+ "default": "http://localhost:3000/api"
1081
+ }
1082
+ }
1083
+ }