Atimeüs

Creates a new record of the given entity type. This performs a real write - use deliberately. Call get_entity_definition first, then pass values as a flat field-name to value map. Returns the created record. Read get_documentation('writes_and_validation') before your first write.

Declares worked time on a project task or an activity for the given days. This performs a real write - use deliberately. taskId comes from list_timesheet_tasks - call it first. On regular tasks and activities a day never holds more than 1 day of work, so a quantity can be silently reduced: always report the quantities the response says were recorded. Exceptional tasks are exempt - uncapped, and not counted towards the day. Read get_documentation('timesheets') for the caps and the refusals.

Permanently deletes a record of the given entity type by id. This performs a real, destructive write - use deliberately, and confirm the record with the user first. Only entity types that support delete appear in the entityType parameter's allowed values. Read get_documentation('writes_and_validation').

Permanently deletes time entries by the workId values get_timesheet reports for the period. This performs a real, destructive write - use deliberately. All the entries must belong to the same employee. The response lists what was deleted, what was not, and the identifiers that did not match any entry. Details: get_documentation('timesheets').

Returns the tenant's current closing month - the period get_timesheet, list_timesheet_tasks and declare_time use when year and month are omitted. It lags behind today's calendar month by the tenant's closing cycle, so call it before reporting any period you did not pass yourself. Read get_documentation('timesheets').

Returns the authenticated caller's profile under user - display name, email, company, division - and their permission matrix under perms. Call it first to resolve 'me' into the employeeId the other tools take. Details: get_documentation('permissions_and_access').

Returns the full content of one documentation subject as markdown: the how-to the tool descriptions leave out - search grammar, entity model, timesheet rules, status workflows, writes and their validation errors. Pass the id a tool description named, or call list_documentation_topics to discover them. Read the subject before acting on it, not after a call fails.

Retrieves a single record of the given entity type with all its fields, by unique identifier. Call get_entity_definition first if you are unsure which fields come back. Details: get_documentation('entity_model').

Returns the field definitions of one entity type: field, searchField, name, fieldType, editable, isReference, dataSourceEntityType, isMandatory and values. Always call it before search_entity, create_entity or update_entity on an entity type you have not used yet. Read get_documentation('entity_model') for what each attribute means.

Returns the monthly timesheet of an employee: its status, the rights the caller has on it, and the day by day time already declared. Call it before declaring or submitting. openDays lists the period's working days, days only the ones already declared. Read get_documentation('timesheets') for how to read the two together.

Lists the documentation subjects available for this Atimeus MCP server, such as how to build search expressions, what the entity model looks like, or how writes and their validation errors work. Returns each subject's id, title, summary, tags and last update in a { data, pagination } envelope; pass pagination.nextCursor as afterTopic until hasMore is false. Pass the ids to get_documentation to read them. An empty list means nothing matched, or nothing has been published yet.

Lists what an employee may declare time on for a given month: the project tasks they are assigned to and the non project activities such as leave, absence or training. Every taskId is what declare_time expects. Listing a task is not permission to declare on it: get_timesheet's rights.canEdit says whether the period still accepts one. An affectation range can cover only part of the month. Read get_documentation('timesheets') before declaring.

Runs a pre-configured analytical indicator and returns its computed results. Call search_indicator_by_name first to get an indicator id. The result shape depends on the indicator type (KPI, series, grouped series, table) and dates are ISO 8601 (yyyy-MM-dd). Read get_documentation('indicators') for the result shapes and the filters.

Searches records of one entity type with a structured query expression (SQE), for instance 'isActive eq true and startDate ge 2024-01-01'. Call get_entity_definition first for this entityType: SQE uses searchField for text (ct/sw/ew) and field for everything else. Returns up to 10 results in a { data, pagination } envelope. Read get_documentation('search_expressions') before your first query: it carries the operators, the value formats and how to page.

Quick search of one entity type by name or description. Only active records are returned; reach a deactivated one with search_entity. Returns up to 10 lightweight results in a { data, pagination } envelope; pass pagination.nextCursor as afterId until hasMore is false. Use search_entity for field-level filtering. Details: get_documentation('pagination').

Searches for indicators by name or keyword. Returns up to 10 results in a { data, pagination } envelope; pass pagination.nextCursor as afterId until hasMore is false. Details: get_documentation('indicators').

Sends feedback on this MCP server to the Atimeüs team as a support ticket: documentation that is missing or ambiguous, an unclear instruction or error, or a feature the user asked for. This is a real, destructive write that cannot be recalled, sent under the user's name and email: show the user what you will send and get their agreement first. Never include the tenant's business data. Details: get_documentation('getting_started').

Updates one or more fields of an existing record of the given entity type. This performs a real, destructive write - use deliberately: it overwrites the previous values. Only the fields provided in 'fields' are changed. Call get_entity_definition first. Returns the updated record. Read get_documentation('writes_and_validation') before your first write.

Moves the monthly timesheet of an employee through its status workflow: Complete, Validate, Close or Unlock. This performs a real, destructive write - use deliberately, and never assume the month. Each transition is allowed from one status only, so read the current status with get_timesheet first. Read get_documentation('timesheet_status_workflow') before calling: it carries the transitions, the error codes and the rules on comments and feedback levels.