Auvo MCP by usefulapi
List tasks, customers and receivables; create tasks and customers in Auvo.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"auvo": {
"url": "https://auvo.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://auvo.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (19)
🟢auvo_list_users(filter, page, pageSize, order)
List the admin, manager and technician users of the Auvo account (paged). Auvo API: GET /users.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: userId, name, smartPhoneNumber, userType (1 user, 2 manager, 3 administrator), externalId.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_get_user(id)
Return one Auvo user by id. Auvo API: GET /users/{id}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "Record id from a list call."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_customers(filter, page, pageSize, order)
List customers of the Auvo account (paged). Auvo API: GET /customers.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: id, description (name), externalId, segmentId, groupId, active, dateLastUpdate, creationDate, legalName, cpfCnpj.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_get_customer(id)
Return one Auvo customer by id. Auvo API: GET /customers/{id}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "Record id from a list call."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_customer_groups(filter)
List the customer groups of the Auvo account (labels that group customers). Auvo API: GET /customergroups.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: id, description.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_tasks(filter, page, pageSize, order)
List field-service tasks (work orders). Filter by date range, technician, customer, team or status. Auvo API: GET /tasks.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: taskID, externalId, idUserTo, startDate and endDate (yyyy-MM-dd), type, typeList, customerId, customerGroupId, teamId, status (0 not finished, 1 auto finished, 2 manual finished, 3 auto or manual, 4 all, 5 with pendency, 6 started or finished, 7 in execution), orientation, tags, priority (1 low, 2 medium, 3 high), dateLastUpdate, questionnairesId.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_get_task(id)
Return one Auvo task by id. Auvo API: GET /tasks/{id}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "Record id from a list call."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_task_types(filter, page, pageSize, order)
List the task types (ids used when creating a task). Auvo API: GET /tasktypes.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: id, description.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_products(filter, page, pageSize, order)
List products (parts and stock items) of the Auvo account. Auvo API: GET /products.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: id, externalId, name, description, categoryId, associatedEquipmentId, active, lowerThanMinimumStock.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_services(filter, page, pageSize, order)
List services (billable work items) of the Auvo account. Auvo API: GET /services.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: id, title, description, externalCode, price, active, fiscalServiceId.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_equipments(filter, page, pageSize, order)
List customer equipments (assets) of the Auvo account. Auvo API: GET /equipments.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: externalId, name, identifier, associatedUserId, associatedCustomerId, parentEquipmentId, categoryId, active, warrantyStartDate, warrantyEndDate.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_teams(filter, page, pageSize, order)
List the teams of the Auvo account. Auvo API: GET /teams.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: id, description.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_tickets(filter, page, pageSize, order)
List support tickets of the Auvo account. Auvo API: GET /tickets.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: ids, status, responsableUsersIds, teamIds, customerGroupId, customerId, priorities, externalId, statusIds, startDate, endDate, startDateLastUpdate, endDateLastUpdate.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_get_ticket(id)
Return one Auvo ticket by id. Auvo API: GET /tickets/{id}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "Record id from a list call."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_invoices(filter, page, pageSize, order)
List invoices issued through Auvo. Auvo API: GET /invoices.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: customerId, status, startDate, endDate.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_receivables(filter, page, pageSize, order)
List receivables (amounts due from customers). Auvo API: GET /receivables.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: customerId, bankAccountId, status, isRecurrent, dueDateFrom, dueDateTo.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢auvo_list_expenses(filter, page, pageSize, order)
List expenses booked by users (for example travel or materials). Auvo API: GET /expenses.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "Filter object sent as Auvo paramFilter. Known keys: startDate, endDate, userToId, type, id, description.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"pageSize": {
"description": "Records per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"order": {
"description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
"anyOf": [
{
"type": "string",
"enum": [
"asc",
"desc"
]
},
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴auvo_create_customer(name, externalId, email, phoneNumber, address, ...)
Create a customer in the Auvo account. Creates a new record each call. Auvo API: POST /customers.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"description": "Customer name.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"externalId": {
"description": "Your own id for this customer.",
"type": "string",
"maxLength": 255
},
"email": {
"description": "Email addresses.",
"type": "array",
"items": {
"type": "string"
}
},
"phoneNumber": {
"description": "Phone numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"address": {
"description": "Address.",
"type": "string"
},
"cpfCnpj": {
"description": "Brazilian CPF or CNPJ.",
"type": "string"
},
"note": {
"description": "Notes.",
"type": "string",
"maxLength": 5000
},
"segmentId": {
"description": "Segment id from the Auvo account.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"groupsId": {
"description": "Customer group ids from auvo_list_customer_groups.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"active": {
"description": "Whether the customer is active.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴auvo_create_task(idUserFrom, orientation, priority, idUserTo, taskType, ...)
Create a field-service task for a technician. Creates a new task and notifies the assignee. Auvo API: POST /tasks.
입력 스키마
{
"type": "object",
"properties": {
"idUserFrom": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "User id that opens the task (required)."
},
"orientation": {
"type": "string",
"minLength": 1,
"maxLength": 5000,
"description": "Task instructions (required)."
},
"priority": {
"type": "integer",
"minimum": 1,
"maximum": 3,
"description": "1 low, 2 medium, 3 high (required)."
},
"idUserTo": {
"description": "User id of the technician who executes the task.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"taskType": {
"description": "Task type id from auvo_list_task_types.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"taskDate": {
"description": "Execution date and time, yyyy-MM-ddTHH:mm:ss.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"
},
"customerId": {
"description": "Customer id from auvo_list_customers.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"teamId": {
"description": "Team id from auvo_list_teams.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"address": {
"description": "Address of the task.",
"type": "string"
},
"latitude": {
"description": "Latitude of the task.",
"type": "number"
},
"longitude": {
"description": "Longitude of the task.",
"type": "number"
},
"checkinType": {
"description": "Check-in type: 1 manual, 2 automatic, 3 user.",
"type": "integer",
"minimum": 1,
"maximum": 3
},
"questionnaireId": {
"description": "Checklist id from the Auvo account.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"externalId": {
"description": "Your own id for this task.",
"type": "string",
"maxLength": 255
}
},
"required": [
"idUserFrom",
"orientation",
"priority"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거