Maintainly MCP by usefulapi
List maintenance tasks, set task assignees, comment on tasks and report work requests in Maintainly.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (3)
- LOWTool 'maintainly_get_work_request' description lacks action verben maintainly_get_work_request
- LOWTool 'maintainly_add_task_comment' description lacks action verben maintainly_add_task_comment
- LOWTool 'maintainly_list_task_assignment' name length outside 3-30 rangeen maintainly_list_task_assignment
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"maintainly": {
"url": "https://maintainly.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://maintainly.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (9)
🟢maintainly_get_me
Return the signed-in user and every profile this token reaches, with each organisation's route key. Use it to find the organisation key.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢maintainly_list_tasks(filter, page, per_page)
List maintenance tasks in the organisation, newest first. Filter with GitHub-style terms, such as status:open, type:reactive or due:<2026-12-31.
Esquema de entrada
{
"type": "object",
"properties": {
"filter": {
"description": "GitHub-style filter terms, for example \"status:open type:reactive\". Quote values with spaces: assignee:\"Jane Smith\".",
"type": "string",
"maxLength": 500
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page (default 100, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢maintainly_get_task(task)
Return one task in full: assignees, work logs, materials, downtimes, checklists and its work request.
Esquema de entrada
{
"type": "object",
"properties": {
"task": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The task number (from maintainly_list_tasks)."
}
},
"required": [
"task"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢maintainly_list_task_assignment(task)
List the users assigned to a task and the users not assigned. Use the user guids here with maintainly_assign_task.
Esquema de entrada
{
"type": "object",
"properties": {
"task": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The task number (from maintainly_list_tasks)."
}
},
"required": [
"task"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢maintainly_list_work_requests(filter, page, per_page)
List work requests (problems reported for an asset or location), with their status and the task raised from each. Filter with GitHub-style terms.
Esquema de entrada
{
"type": "object",
"properties": {
"filter": {
"description": "GitHub-style filter terms, for example \"status:open type:reactive\". Quote values with spaces: assignee:\"Jane Smith\".",
"type": "string",
"maxLength": 500
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page (default 100, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢maintainly_get_work_request(work_request)
Return one work request with its description, reporter details, files and linked task.
Esquema de entrada
{
"type": "object",
"properties": {
"work_request": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The work request guid (from maintainly_list_work_requests)."
}
},
"required": [
"work_request"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴maintainly_assign_task(task, user_guids)
Set the assignees of a task to exactly these users. Send every user who should stay assigned, because the request sets the full list. Get guids from maintainly_list_task_assignment.
Esquema de entrada
{
"type": "object",
"properties": {
"task": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The task number (from maintainly_list_tasks)."
},
"user_guids": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"description": "The guids of the users to assign."
}
},
"required": [
"task",
"user_guids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡maintainly_add_task_comment(task, comment)
Post a comment on a task. The comment is visible to everyone who can see the task.
Esquema de entrada
{
"type": "object",
"properties": {
"task": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The task number (from maintainly_list_tasks)."
},
"comment": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "The comment text."
}
},
"required": [
"task",
"comment"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡maintainly_create_work_request(title, description, location, asset_guid)
Create a work request that reports a problem. It starts as open and can become a task after review.
Esquema de entrada
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Short summary of the problem."
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "What is wrong and where."
},
"location": {
"description": "Where the problem is, as free text.",
"type": "string",
"maxLength": 255
},
"asset_guid": {
"description": "Optional guid of the asset the problem concerns.",
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"title",
"description"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia