DicksonOne MCP by usefulapi
List alerts and data loggers, count active alerts, and acknowledge alerts in DicksonOne.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"dicksonone": {
"url": "https://dicksonone.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://dicksonone.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (7)
🟢dicksonone_whoami
Return the DicksonOne user that the API token belongs to. Good first call to confirm the connection. REST API: GET /api/rest/whoami.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢dicksonone_list_alerts(tokens, location_ids, channel_ids, active, severity, ...)
List historical alerts for the account: a logger tripped a warning or excursion condition. Each alert has severity, type, excursion_at, returned_to_normal_at, acknowledged_at and its location, device and channel. Filter by logger, location, severity, type, active state or time window. Paginated. REST API: GET /api/rest/alerts.
입력 스키마
{
"type": "object",
"properties": {
"tokens": {
"description": "Restrict to data loggers by token (from dicksonone_list_devices).",
"type": "array",
"items": {
"type": "string"
}
},
"location_ids": {
"description": "Restrict to locations by id (from dicksonone_list_locations).",
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric id."
}
},
"channel_ids": {
"description": "Restrict to channels by id.",
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric id."
}
},
"active": {
"description": "true = only active alerts (not yet returned to normal).",
"type": "boolean"
},
"severity": {
"description": "Alert severity (default all).",
"type": "string",
"enum": [
"all",
"excursion",
"warning"
]
},
"type": {
"description": "Alert type (default all).",
"type": "string",
"enum": [
"all",
"not_reporting",
"high_low"
]
},
"started_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})$",
"description": "ISO-8601 timestamp, for example 2026-11-01T00:00:00Z."
},
"started_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})$",
"description": "ISO-8601 timestamp, for example 2026-11-01T00:00:00Z."
},
"ended_after": {
"description": "Only alerts resolved after this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})$"
},
"ended_before": {
"description": "Only alerts resolved before this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})$"
},
"page_number": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 25, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢dicksonone_get_alert_summary(tokens, location_ids, channel_ids, active, severity, ...)
Count active and cleared alerts, and alerts by severity (excursion, warning), for the account or for a filtered set. REST API: GET /api/rest/alerts/summary.
입력 스키마
{
"type": "object",
"properties": {
"tokens": {
"description": "Restrict to data loggers by token (from dicksonone_list_devices).",
"type": "array",
"items": {
"type": "string"
}
},
"location_ids": {
"description": "Restrict to locations by id (from dicksonone_list_locations).",
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric id."
}
},
"channel_ids": {
"description": "Restrict to channels by id.",
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric id."
}
},
"active": {
"description": "true = only active alerts (not yet returned to normal).",
"type": "boolean"
},
"severity": {
"description": "Alert severity (default all).",
"type": "string",
"enum": [
"all",
"excursion",
"warning"
]
},
"type": {
"description": "Alert type (default all).",
"type": "string",
"enum": [
"all",
"not_reporting",
"high_low"
]
},
"started_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})$",
"description": "ISO-8601 timestamp, for example 2026-11-01T00:00:00Z."
},
"started_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})$",
"description": "ISO-8601 timestamp, for example 2026-11-01T00:00:00Z."
},
"ended_after": {
"description": "Only alerts resolved after this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})$"
},
"ended_before": {
"description": "Only alerts resolved before this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢dicksonone_list_alert_comments(alert_id, page_number, page_size)
List the comments that users added to one alert, with author and time. Paginated. REST API: GET /api/rest/alerts/{alert_id}/comments.
입력 스키마
{
"type": "object",
"properties": {
"alert_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "The alert id (from dicksonone_list_alerts)."
},
"page_number": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 25, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"alert_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢dicksonone_list_locations(name, ids, page_number, page_size)
List the locations (sites, rooms, fridges) on the account, with their sublocation ids. Use the ids to filter alerts. Filter by name or by a list of ids. Paginated. REST API: GET /api/rest/locations.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"description": "Filter by location name.",
"type": "string"
},
"ids": {
"description": "Only these location ids.",
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric id."
}
},
"page_number": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 25, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢dicksonone_list_devices(name, include_archived, include_replacements, page_number, page_size)
List the data loggers (devices) on the account. Each logger has a string token that stays the same across hardware replacements; use the token to filter alerts. Optionally filter by name and include archived or replaced loggers. Paginated. REST API: GET /api/rest/devices.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"description": "Filter by logger name.",
"type": "string"
},
"include_archived": {
"description": "Include archived loggers (default false).",
"type": "boolean"
},
"include_replacements": {
"description": "Include older serials of replaced loggers (default false).",
"type": "boolean"
},
"page_number": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page_size": {
"description": "Results per page (default 25, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡dicksonone_acknowledge_alert(alert_id)
Acknowledge one alert. The API sets the acknowledger to the user of the token and the time to the server time. An alert that is already acknowledged returns HTTP 409; the tool reports that as an error, and nothing changes. REST API: POST /api/rest/alerts/{alert_id}/acknowledgements.
입력 스키마
{
"type": "object",
"properties": {
"alert_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "The alert id to acknowledge (from dicksonone_list_alerts)."
}
},
"required": [
"alert_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거