DicksonOne MCP by usefulapi

List alerts and data loggers, count active alerts, and acknowledge alerts in DicksonOne.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
80%
이름 품질
80%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,348토큰 (도구 정의)
~2.5 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.83%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 7개