{"openapi":"3.1.0","info":{"title":"Linode Monitor (BYOK) API","version":"0.1.0","description":"Linode Monitor (BYOK) lets an AI assistant read your own Linode Monitor data through the Linode Monitor API with a key you supply (personal access token (read-only scopes are enough)). Read-only: 9 tools (list_monitor_services, list_metric_definitions, list_all_dashboards, list_service_dashboards, get_dashboard, list_alert_definitions, list_service_alert_definitions, get_alert_definition,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-linode-monitor.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-linode-monitor/docs"},"termsOfService":"https://connectorbay.com/byok-linode-monitor/terms"},"servers":[{"url":"https://byok-linode-monitor.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-linode-monitor/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_monitor_services":{"post":{"operationId":"list_monitor_services","summary":"List the service types that Akamai Cloud monitoring supports (for example managed databases) with their labels. Use for ","description":"List the service types that Akamai Cloud monitoring supports (for example managed databases) with their labels. Use for \"Which Linode services can be monitored with Cloud Monitor\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_monitor_servicesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_metric_definitions":{"post":{"operationId":"list_metric_definitions","summary":"List the metrics available for one monitored service type with label, unit, metric type, scrape interval, aggregate func","description":"List the metrics available for one monitored service type with label, unit, metric type, scrape interval, aggregate functions, dimensions and whether alerts can use it. Use for \"Which metrics can I chart or alert on for Linode managed databases\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"service_type":{"description":"Monitored service type, as returned by list_monitor_services, for example 'dbaas' or 'linode'.","maxLength":64,"title":"Service Type","type":"string"}},"required":["service_type"],"title":"list_metric_definitionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_all_dashboards":{"post":{"operationId":"list_all_dashboards","summary":"List all Cloud Monitor dashboards with service type and the widgets (metric, aggregate function, chart type, unit) they ","description":"List all Cloud Monitor dashboards with service type and the widgets (metric, aggregate function, chart type, unit) they show. Use for \"Which Cloud Monitor dashboards exist for my Linode account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_all_dashboardsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_service_dashboards":{"post":{"operationId":"list_service_dashboards","summary":"List the dashboards of one monitored service type with their widgets. Use for \"Which dashboards exist for the dbaas serv","description":"List the dashboards of one monitored service type with their widgets. Use for \"Which dashboards exist for the dbaas service type\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"service_type":{"description":"Monitored service type, as returned by list_monitor_services, for example 'dbaas' or 'linode'.","maxLength":64,"title":"Service Type","type":"string"}},"required":["service_type"],"title":"list_service_dashboardsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_dashboard":{"post":{"operationId":"get_dashboard","summary":"Get one Cloud Monitor dashboard by numeric id with its widgets. Use for \"What does Cloud Monitor dashboard 1 show\".","description":"Get one Cloud Monitor dashboard by numeric id with its widgets. Use for \"What does Cloud Monitor dashboard 1 show\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dashboard_id":{"description":"Numeric dashboard id, as returned by list_all_dashboards.","minimum":1,"title":"Dashboard Id","type":"integer"}},"required":["dashboard_id"],"title":"get_dashboardArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_alert_definitions":{"post":{"operationId":"list_alert_definitions","summary":"List alert definitions across all service types with severity, status, covered entities, trigger conditions and rule cri","description":"List alert definitions across all service types with severity, status, covered entities, trigger conditions and rule criteria. Use for \"Which Cloud Monitor alerts are set up and which are disabled\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_alert_definitionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_service_alert_definitions":{"post":{"operationId":"list_service_alert_definitions","summary":"List the alert definitions of one monitored service type with severity, status, trigger conditions and rule criteria. Us","description":"List the alert definitions of one monitored service type with severity, status, trigger conditions and rule criteria. Use for \"Which alerts exist for managed databases\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"service_type":{"description":"Monitored service type, as returned by list_monitor_services, for example 'dbaas' or 'linode'.","maxLength":64,"title":"Service Type","type":"string"}},"required":["service_type"],"title":"list_service_alert_definitionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_alert_definition":{"post":{"operationId":"get_alert_definition","summary":"Get one alert definition by service type and numeric id: severity, status, covered entities, trigger conditions and rule","description":"Get one alert definition by service type and numeric id: severity, status, covered entities, trigger conditions and rule thresholds. Use for \"What threshold triggers alert 10 for dbaas\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"service_type":{"description":"Monitored service type, as returned by list_monitor_services, for example 'dbaas' or 'linode'.","maxLength":64,"title":"Service Type","type":"string"},"alert_id":{"description":"Numeric alert definition id, as returned by list_alert_definitions.","minimum":1,"title":"Alert Id","type":"integer"}},"required":["service_type","alert_id"],"title":"get_alert_definitionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_alert_channels":{"post":{"operationId":"list_alert_channels","summary":"List alert notification channels with id, label, channel type (email) and whether they are system or user defined. Recip","description":"List alert notification channels with id, label, channel type (email) and whether they are system or user defined. Recipient addresses are not returned. Use for \"Which alert notification channels are configured in Cloud Monitor\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_alert_channelsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}