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"
}コミュニティ
エビデンス