{"name":"ai.timix/time-tracking","title":"Timix.AI","url":"https://api.timix.ai/api/integration/v1/mcp","host":"api.timix.ai","read_at":"2026-11-10T15:26:19.326217+00:00","grade":"A","score":100,"capped":null,"graded":true,"pending_second_read":[],"counts":{"error":0,"warning":0,"info":1},"findings":[{"rule":"mcp-tools-changed","severity":"info","message":"Its tools changed since last week. Tools 1 added, 15 described, 114 with new hints. Now saying they may change more (read-only no longer, or destructive): approve_timesheet, bulk_update_cost_rates, bulk_update_time_reports, cancel_invite, cancel_scheduled_report. Where: get_financial_analytics, bulk_update_cost_rates, delete_subtask, enable_user, get_employee_timesheet and 110 more.","fix":"","where":["get_financial_analytics","bulk_update_cost_rates","delete_subtask","enable_user","get_employee_timesheet","manage_user_work_schedule","move_project","move_subtask","move_task","permanent_delete_entity","remove_user_from_customer","remove_user_project","restore_entity","search","set_custom_field_value","update_draft_invoice","approve_timesheet","assign_user_to_customer","assign_user_to_project","bulk_create_time_reports","bulk_update_time_reports","cancel_invite","cancel_scheduled_report","cancel_timer","change_user_role","check_budget_limits","close_frame_order","close_month","commit_import","copy_period","create_credit_note","create_custom_field","create_customer","create_favorite","create_frame_order","create_holiday_profile","create_project","create_scheduled_report","create_subtask","create_task","create_time_report","delete_api_key","delete_custom_field","delete_customer","delete_draft_invoice","delete_favorite","delete_frame_order","delete_holiday_profile","delete_organization","delete_project"],"count":115}],"handshake":{"answered":true,"mcp":true,"era":"handshake","protocol_version":"2025-11-25","server_info":{"name":"timix-mcp","version":"1.0.0","title":null},"capabilities":["tools"]},"sign_in":null,"tools":[{"name":"get_hours_summary","title":"Get hours summary","description":"Get a summary of hours logged for a user or team over a date range","read_only":true,"destructive":false,"inputs":["start_date","end_date","scope"],"required":["start_date","end_date"],"price_stated_usd":null},{"name":"get_dashboard_metrics","title":"Get dashboard metrics","description":"Get organization dashboard metrics including utilization, revenue, and active projects","read_only":true,"destructive":false,"inputs":["month"],"required":[],"price_stated_usd":null},{"name":"get_customer_info","title":"Get customer info","description":"Get detailed information about a customer including health score and portfolio","read_only":true,"destructive":false,"inputs":["customer_id"],"required":["customer_id"],"price_stated_usd":null},{"name":"get_project_status","title":"Get project status","description":"Get detailed project status including budget, hours, and task breakdown","read_only":true,"destructive":false,"inputs":["project_id"],"required":["project_id"],"price_stated_usd":null},{"name":"get_billing_report","title":"Get billing report","description":"Get billing summary for a customer over a date range","read_only":true,"destructive":false,"inputs":["customer_id","start_date","end_date"],"required":["customer_id","start_date","end_date"],"price_stated_usd":null},{"name":"get_budget_alerts","title":"Get budget alerts","description":"Get all budget alerts for the organization showing projects that are over or near budget","read_only":true,"destructive":false,"inputs":[],"required":[],"price_stated_usd":null},{"name":"list_customers","title":"List customers","description":"List all customers in the organization","read_only":true,"destructive":false,"inputs":[],"required":[],"price_stated_usd":null},{"name":"list_projects","title":"List projects","description":"List all projects in the organization with their status and budget information","read_only":true,"destructive":false,"inputs":["customer_id"],"required":[],"price_stated_usd":null},{"name":"get_my_time_entries","title":"Get my time analytics","description":"Get the current user's time entry analytics for a date range, including hours breakdown by project and customer, billable vs non-billable split, and target comparison","read_only":true,"destructive":false,"inputs":["start_date","end_date"],"required":["start_date","end_date"],"price_stated_usd":null},{"name":"get_resource_utilization","title":"Get resource utilization","description":"Get team resource utilization summary showing target hours, actual hours, billable hours, and utilization percentage for the organization","read_only":true,"destructive":false,"inputs":["start_date","end_date"],"required":["start_date","end_date"],"price_stated_usd":null},{"name":"get_unbilled_time","title":"Get unbilled time","description":"Get a summary of unbilled time across the organization, including total hours, total amount, number of entries, and aging information","read_only":true,"destructive":false,"inputs":[],"required":[],"price_stated_usd":null},{"name":"get_budget_health","title":"Get budget health","description":"Get overall budget health summary for the organization, including project counts by status (on-track, warning, critical), total remaining budget hours, and active alerts","read_only":true,"destructive":false,"inputs":[],"required":[],"price_stated_usd":null},{"name":"get_employee_timesheet","title":"Get employee timesheet","description":"Get an employee's timesheet report showing target hours, actual hours logged, and variance. Can look up by employee name or default to the requesting user.","read_only":true,"destructive":false,"inputs":["employee_name","start_date","end_date"],"required":["start_date","end_date"],"price_stated_usd":null},{"name":"get_financial_analytics","title":"Get financial analytics","description":"Aggregate financial analytics for the organization. Use metric_type to pick the roll-up: 'project_margin_ranking' ranks projects by budget margin (best/worst), 'effective_bill_rate' returns the blended revenue-per-hour, 'utilization_rollup' returns team billable efficiency, 'revenue_summary' returns org budget health plus reported hours. Requires Finance access (Owner, Admin, Finance, or Manager role).","read_only":true,"destructive":false,"inputs":["metric_type","start_date","end_date"],"required":["metric_type"],"price_stated_usd":null},{"name":"list_my_time_entries","title":"List my time entries","description":"List the current user's own individual time entries for a date range: for each, its time_report_id (what update_time_report and delete_time_report take), date, start and end time of day on the organization's clock, project and subtask names and ids, hours, description, billable flag and status. Use this to see exactly what was logged (the per-entry detail), as opposed to aggregated totals, and to find the entry the user wants to change or delete.","read_only":true,"destructive":false,"inputs":["start_date","end_date","limit"],"required":["start_date","end_date"],"price_stated_usd":null},{"name":"find_billing_work","title":"Find billing work","description":"Find the projects, tasks and subtasks in your organization where time can be tracked. Pass a name fragment as query to search customer, project, task and subtask names at once: every matching subtask comes back in `matches` with its full path (customer > project > task > subtask) and its subtask_id - then the subtasks of every customer of that name, and, when no subtask or task has that name, the subtasks of every project of that name. When two or more of the activities found have the same name (\"General\" under two clients), `choose_one` says where each one is: ask the user which one they mean, unless they already said. Use this to locate where to record work. Returns ids and names only.","read_only":true,"destructive":false,"inputs":["query","project_id","max_results"],"required":[],"price_stated_usd":null},{"name":"get_project_team","title":"Get project team","description":"Get the people associated with a project: who is ASSIGNED to it (formally responsible / accountable) and the TOP CONTRIBUTORS by hours logged (who is actually doing the work and driving the budget/overrun). Use this to answer 'who is responsible for / working on a project', especially when a project is over budget. Budget-alert results include the project_id you can pass directly into this tool.","read_only":true,"destructive":false,"inputs":["project_id"],"required":["project_id"],"price_stated_usd":null},{"name":"log_time","title":"Log time","description":"Create a single time entry on a subtask for the current user. Requires permission to log time.","read_only":false,"destructive":false,"inputs":["subtask_id","date","hours","start_time","text"],"required":["subtask_id","date","hours"],"price_stated_usd":null},{"name":"suggest_holiday_profile","title":"Suggest holiday profile","description":"Look up the official public/national holidays for a country (ISO-2 code, e.g. US, IL, GB) and year from an authoritative public source (Hebcal for Israel, Nager.Date for everywhere else). Returns a DRAFT list of holiday dates: each is either a full day off or a half/partial working day (with a start/end working window). Use this to PROPOSE a holiday profile — never invent holiday dates from memory. The dates returned are authoritative for that exact year.","read_only":true,"destructive":false,"inputs":["country","year"],"required":["country","year"],"price_stated_usd":null},{"name":"create_holiday_profile","title":"Create holiday profile","description":"Create and SAVE a national-holiday profile for the organization for a specific year, AFTER the user has explicitly reviewed and confirmed the holiday list. Each holiday is either a full day off or a half/partial working day (with a start/end working window). Holiday dates MUST come from suggest_holiday_profile or the user — never invent dates. Only call this once the user has confirmed; do not call it to preview.","read_only":false,"destructive":true,"inputs":["name","year","holidays","default_for_countries","set_as_default","source","notes"],"required":["name","year","holidays"],"price_stated_usd":null},{"name":"create_customer","title":"Create customer","description":"Create a new billing customer in your organization. The organization is fixed by your context - never pass an organization id.","read_only":false,"destructive":false,"inputs":["name","description","currency","country","contact_email","idempotency_key"],"required":["name"],"price_stated_usd":null},{"name":"create_project","title":"Create project","description":"Create a new billing project under one of your customers. The organization is fixed by your context; customer_id must be a customer in your organization. Discover ids with find_billing_work - never ask the user for an id.","read_only":false,"destructive":false,"inputs":["customer_id","name","description","billing_type","create_general_activity","idempotency_key"],"required":["customer_id","name","billing_type"],"price_stated_usd":null},{"name":"create_task","title":"Create task","description":"Create a task under a project. Tasks group the subtasks that time is logged against. The task inherits its allowed billing types from the parent project. Discover ids with find_billing_work - never ask the user for an id.","read_only":false,"destructive":false,"inputs":["project_id","name","description","create_general_activity","idempotency_key"],"required":["project_id","name"],"price_stated_usd":null},{"name":"create_subtask","title":"Create subtask","description":"Create a subtask under a task. All time entries are logged against subtasks, so every task needs at least one. The subtask inherits a valid billing type from the parent task. Discover ids with find_billing_work - never ask the user for an id.","read_only":false,"destructive":false,"inputs":["task_id","name","description","idempotency_key"],"required":["task_id","name"],"price_stated_usd":null},{"name":"invite_user","title":"Invite user","description":"Invite a person to join your organization by email at a chosen role. The organization is fixed by your context - never pass an organization id. Valid roles: Admin, Finance, Manager, Member, Viewer (you can only invite at a role no more privileged than your own). Once the user confirms, the invitation is created and the invitee is emailed an acceptance link. The result's mail_sent says whether that email went out: say the invitation was emailed ONLY when mail_sent is true. When mail_sent is false the invitation exists but its email could not be sent - say so, and that an admin can resend it or copy its link from the Users page.","read_only":false,"destructive":true,"inputs":["email","role","idempotency_key"],"required":["email","role"],"price_stated_usd":null},{"name":"assign_user_to_project","title":"Assign user to project","description":"Assign a member to a project so they can see it and log time against its tasks. Identify the member by email (preferred) or by org_user_id, and the project by project_id (discover ids with find_billing_work - never ask the user for an id). The organization is fixed by your context.","read_only":false,"destructive":false,"inputs":["project_id","email","org_user_id","idempotency_key"],"required":["project_id"],"price_stated_usd":null},{"name":"update_org_settings","title":"Update organization settings","description":"Update core settings for your organization: name, country, default_time_zone, base_currency, first_day_of_month (1-28), auto_close_month_after_days, and the budget alert thresholds (budget_warning_threshold_percent must be less than budget_critical_threshold_percent). The organization is fixed by your context - never pass an organization id. Only the fields you provide are changed; everything else is left as-is.","read_only":false,"destructive":true,"inputs":["name","country","default_time_zone","base_currency","first_day_of_month","auto_close_month_after_days","budget_warning_threshold_percent","budget_critical_threshold_percent","idempotency_key"],"required":[],"price_stated_usd":null},{"name":"update_customer","title":"Update customer","description":"Update an existing billing customer in your organization. Only the fields you provide are changed; everything else is left as-is (PATCH semantics). Discover ids with find_billing_work - never ask the user for an id.","read_only":false,"destructive":true,"inputs":["customer_id","name","description","country","contact_name","contact_email","contact_phone","currency","status","idempotency_key"],"required":["customer_id"],"price_stated_usd":null},{"name":"update_project","title":"Update project","description":"Update an existing billing project in your organization. Only the fields you provide are changed (PATCH semantics). You can rename the project, update its description, change its status, toggle which billing types are allowed (TM/Fix/OVH), and set per-type hour limits. Discover ids with find_billing_work - never ask the user for an id.","read_only":false,"destructive":true,"inputs":["project_id","name","description","status","billing_types","tm_hour_limit","fix_hour_limit","ovh_hour_limit","idempotency_key"],"required":["project_id"],"price_stated_usd":null},{"name":"update_task","title":"Update task","description":"Update an existing task in your organization. Only the fields you provide are changed (PATCH semantics). You can rename the task, update its description, change its status, and set per-type hour limits. Discover ids with find_billing_work - never ask the user for an id.","read_only":false,"destructive":true,"inputs":["task_id","name","description","status","tm_hour_limit","fix_hour_limit","ovh_hour_limit","idempotency_key"],"required":["task_id"],"price_stated_usd":null},{"name":"update_subtask","title":"Update subtask","description":"Update an existing subtask in your organization. Only the fields you provide are changed (PATCH semantics). You can rename the subtask, update its description, change its status, billing type, and set an hour limit. Discover ids with find_billing_work - never ask the user for an id.","read_only":false,"destructive":true,"inputs":["subtask_id","name","description","status","billing_type","hour_limit","idempotency_key"],"required":["subtask_id"],"price_stated_usd":null},{"name":"create_time_report","title":"Create time entry","description":"Create a new time entry on a subtask for the current user. The entry is always attributed to you — you cannot create entries on behalf of another user. Supply subtask_id, the date (ISO 8601 YYYY-MM-DD), start_time (HH:mm; when omitted, right after your last entry that day, or 09:00 on a day with nothing logged), and hours.","read_only":false,"destructive":false,"inputs":["subtask_id","date","hours","start_time","text","idempotency_key"],"required":["subtask_id","date","hours"],"price_stated_usd":null},{"name":"update_time_report","title":"Update time entry","description":"Update fields on one of your own time entries (PATCH — only the fields you supply are changed; everything else is left as-is). Supply the time_report_id plus any combination of date, start_time, hours, and text.","read_only":false,"destructive":true,"inputs":["time_report_id","date","hours","start_time","text","idempotency_key"],"required":["time_report_id"],"price_stated_usd":null},{"name":"bulk_create_time_reports","title":"Create time entries in bulk","description":"Create multiple time entries in one call. Supply an 'entries' array where each item has subtask_id, date (YYYY-MM-DD), and hours (> 0 and ≤ 24); optionally start_time (HH:mm; when omitted, the entry goes after your last entry that day and after the batch's other entries — 09:00 on a day with nothing logged) and text. Entries are always attributed to you. Returns per-item results (partial failures are reported rather than aborting the batch). Max 50 entries.","read_only":false,"destructive":false,"inputs":["entries","idempotency_key"],"required":["entries"],"price_stated_usd":null},{"name":"bulk_update_time_reports","title":"Update time entry descriptions in bulk","description":"Apply a common text description update to multiple of your own time entries. Supply ids (list of time-report ids, max 100) and text (the new description). Returns per-id results — partial failures are reported rather than aborting the whole batch.","read_only":false,"destructive":true,"inputs":["ids","text","idempotency_key"],"required":["ids","text"],"price_stated_usd":null},{"name":"copy_period","title":"Copy time entries to a new period","description":"Copy your own time entries from a source date range into a target date range, preserving each entry's weekday offset relative to the source start (e.g. copy last week to this week). New entries are created as Draft. The source range cannot exceed 31 days. Supply source_start_date, source_end_date, and target_start_date (all ISO 8601 YYYY-MM-DD).","read_only":false,"destructive":false,"inputs":["source_start_date","source_end_date","target_start_date","idempotency_key"],"required":["source_start_date","source_end_date","target_start_date"],"price_stated_usd":null},{"name":"start_timer","title":"Start timer (replaces a running one)","description":"Start (or replace) your running timer on a subtask. There is at most one running timer per user; starting a new one replaces any existing. Stop it later with stop_timer to create a Draft time entry, or cancel it with cancel_timer to discard it. Supply subtask_id.","read_only":false,"destructive":true,"inputs":["subtask_id","description","idempotency_key"],"required":["subtask_id"],"price_stated_usd":null},{"name":"stop_timer","title":"Stop timer","description":"Stop your running timer (a paused one too). The time it ran - its pauses left out - is saved as a Draft time entry automatically. Returns the created time entry. No arguments needed.","read_only":false,"destructive":true,"inputs":["idempotency_key"],"required":[],"price_stated_usd":null},{"name":"cancel_timer","title":"Cancel timer","description":"Cancel (discard) your running timer without creating a time entry. The elapsed time is lost. No arguments needed.","read_only":false,"destructive":true,"inputs":["idempotency_key"],"required":[],"price_stated_usd":null},{"name":"submit_timesheet","title":"Submit timesheet","description":"Submit your time entries for a given month for manager approval. Draft and Rejected entries in the month are transitioned to Submitted. A billing-closed month cannot be submitted. Supply year and month (1-12).","read_only":false,"destructive":true,"inputs":["year","month","idempotency_key"],"required":["year","month"],"price_stated_usd":null},{"name":"recall_timesheet","title":"Recall timesheet","description":"Withdraw your submitted timesheet for a given month back to Draft (un-submit), reopening entries for editing. Only valid while the period is Submitted — after approval ask a manager to reopen it. Supply year and month (1-12).","read_only":false,"destructive":true,"inputs":["year","month","idempotency_key"],"required":["year","month"],"price_stated_usd":null},{"name":"assign_user_to_customer","title":"Assign user to customer","description":"Assign an organization member to a billing customer so they can see that customer and all its projects. Requires the org_user_id (discover it with get_project_team or get_employee_timesheet) and the customer_id. The organization is fixed by your context — never pass an organization id. You cannot target a user more privileged than yourself (Owner is not targetable by Admin).","read_only":false,"destructive":false,"inputs":["org_user_id","customer_id","idempotency_key"],"required":["org_user_id","customer_id"],"price_stated_usd":null},{"name":"remove_user_project","title":"Remove user from project","description":"Remove an organization member's assignment from a specific project. The user will no longer have direct visibility to that project (they may still see it via a customer assignment). Requires org_user_id and project_id. The organization is fixed by your context — never pass an organization id. You cannot target a user more privileged than yourself. Requires confirm=true to proceed.","read_only":false,"destructive":true,"inputs":["org_user_id","project_id","confirm","idempotency_key"],"required":["org_user_id","project_id"],"price_stated_usd":null},{"name":"enable_user","title":"Enable user","description":"Re-enable a previously disabled organization member so they can log in and use the platform again. Requires the org_user_id. The organization is fixed by your context — never pass an organization id. You cannot target a user more privileged than yourself, and not your own account. It is refused when the organization's plan has no free seat: its active members already fill the plan's limit (error_code SUBSCRIPTION.SEAT_LIMIT_REACHED, with the limit in error_details) — the fix is to upgrade the plan or disable another member first. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["org_user_id","confirm","idempotency_key"],"required":["org_user_id"],"price_stated_usd":null},{"name":"resend_invite","title":"Resend invite","description":"Re-send a pending invitation email to the invitee and reset its status to Pending. Requires the invite_id (discover it via list of pending invites). The organization is fixed by your context — never pass an organization id.","read_only":false,"destructive":true,"inputs":["invite_id","idempotency_key"],"required":["invite_id"],"price_stated_usd":null},{"name":"set_budget_thresholds","title":"Set budget thresholds","description":"Set the organization-level budget alert thresholds. budget_warning_threshold_percent is the utilization % at which a project is flagged At-Risk; budget_critical_threshold_percent is the % at which it is flagged Over-Budget. The warning threshold must be strictly less than the critical threshold. Supply one or both — only the fields you provide are changed (PATCH semantics). The organization is fixed by your context — never pass an organization id.","read_only":false,"destructive":true,"inputs":["budget_warning_threshold_percent","budget_critical_threshold_percent","idempotency_key"],"required":[],"price_stated_usd":null},{"name":"update_user_profile","title":"Update team member profile","description":"Update a team member's organization-profile fields: first name, last name, country, timezone, and job title. Only the fields you provide are changed (PATCH semantics). Role changes are not supported here — use the dedicated role-change tool. The organization is fixed by your context — never pass an organization id. You cannot target a user more privileged than yourself.","read_only":false,"destructive":true,"inputs":["org_user_id","first_name","last_name","country","timezone","job_title","idempotency_key"],"required":["org_user_id"],"price_stated_usd":null},{"name":"update_user_preferences","title":"Update my preferences","description":"Update your own UI preferences: default time-entry view, sub-views, theme, and time format. Only the fields you provide are changed (PATCH semantics). Applies to your account globally across all organizations. The user is fixed by your context — you can only change your own preferences.","read_only":false,"destructive":true,"inputs":["default_time_entry_view","default_day_sub_view","default_week_sub_view","default_month_sub_view","theme_preference","time_format","idempotency_key"],"required":[],"price_stated_usd":null},{"name":"set_user_cost_rate","title":"Set user cost rate","description":"Set the internal hourly COST rate for one member of your organization (used for profit/margin reporting). The organization is fixed by your context - never pass an organization id. You cannot set your own cost rate. The rate value is never echoed back.","read_only":false,"destructive":true,"inputs":["user_id","hourly_rate","currency","effective_from","effective_to","idempotency_key"],"required":["user_id","hourly_rate"],"price_stated_usd":null},{"name":"bulk_update_cost_rates","title":"Bulk update cost rates","description":"Apply an organization-wide adjustment to every member's hourly COST rate, effective from a date. Supply EITHER adjustment_percentage (e.g. 5 to raise all rates by 5%, -3 to cut 3%) OR fixed_amount (add this amount to every rate, e.g. 10 raises a 100 rate to 110), not both. The organization is fixed by your context - never pass an organization id. Rate values are never echoed back.","read_only":false,"destructive":true,"inputs":["effective_from","adjustment_percentage","fixed_amount","idempotency_key"],"required":["effective_from"],"price_stated_usd":null},{"name":"create_custom_field","title":"Create custom field","description":"Define a new custom field on a billing entity type (project, task, subtask, time report, or customer) for your organization. The organization is fixed by your context - never pass an organization id. type is one of String, Number, Date, DateTime, ListOfValues; ListOfValues requires at least one option. Marking a field mandatory blocks creating that entity type until a value is provided.","read_only":false,"destructive":false,"inputs":["entity","field_id","title","type","list_of_values","is_mandatory","idempotency_key"],"required":["entity","field_id","title","type"],"price_stated_usd":null},{"name":"update_custom_field","title":"Update custom field","description":"Update an existing custom field definition (title, type, options, or mandatory flag) in your organization. The organization is fixed by your context. You cannot change a field's field_id or the entity it applies to. Only the properties you supply are changed.","read_only":false,"destructive":true,"inputs":["field_definition_id","title","type","list_of_values","is_mandatory","idempotency_key"],"required":["field_definition_id"],"price_stated_usd":null},{"name":"set_custom_field_value","title":"Set custom field value","description":"Set the value of a custom field on a specific entity (a project, task, subtask, time report, or customer). The custom field must already be defined for that entity type. The organization is fixed by your context. You must have permission to update the target entity. The value is checked the way the app checks a save: the field's type and list options, and every REQUIRED custom field of that entity must have a value (set a missing required field first).","read_only":false,"destructive":true,"inputs":["entity","entity_id","field_id","value","idempotency_key"],"required":["entity","entity_id","field_id","value"],"price_stated_usd":null},{"name":"set_org_work_schedule","title":"Set organization work schedule","description":"Create or update a named organization-level work schedule (a weekly working-time profile). Provide schedule_id to update an existing one, or omit it to create a new one. weekly_schedule is a JSON object mapping lowercase day names to a working window, e.g. {\"monday\":{\"start\":\"09:00\",\"end\":\"18:00\"},\"saturday\":null}. The organization is fixed by your context. On update, only the fields you supply are changed.","read_only":false,"destructive":true,"inputs":["schedule_id","name","weekly_schedule","first_day_of_week","default_for_countries","is_active","notes","idempotency_key"],"required":[],"price_stated_usd":null},{"name":"manage_user_work_schedule","title":"Manage my work schedule","description":"Manage YOUR OWN personal work schedule. action is one of: create, update, delete, assign (assign = make a schedule your active one). For update/delete/assign, provide schedule_id. default_hours is your standard daily hours (for a simple schedule). The organization is fixed by your context, and you can only manage your own schedule. Requires the Admin role.","read_only":false,"destructive":true,"inputs":["action","schedule_id","name","default_hours","is_active","idempotency_key"],"required":["action"],"price_stated_usd":null},{"name":"update_holiday_profile","title":"Update holiday profile","description":"Update an existing holiday profile in your organization (name, holiday list, default-for-countries, active flag, or notes). The organization is fixed by your context. A profile's year cannot be changed. Only the fields you supply are changed; supplying holidays REPLACES the profile's holiday list. Holiday dates must fall within the profile's year.","read_only":false,"destructive":true,"inputs":["profile_id","name","holidays","default_for_countries","is_active","notes","idempotency_key"],"required":["profile_id"],"price_stated_usd":null},{"name":"delete_customer","title":"Delete customer","description":"Soft-delete a billing customer and its whole hierarchy (projects, tasks, subtasks) into the recycle bin, where an admin can restore it. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["customer_id","confirm","idempotency_key"],"required":["customer_id"],"price_stated_usd":null},{"name":"close_month","title":"Close billing month","description":"Close a billing month so no further time can be logged or edited in it. Call once with no token to preview; re-call with the returned confirm_token and an idempotency_key to commit. Reversible only by reopening the month.","read_only":false,"destructive":true,"inputs":["year","month","confirm_token","idempotency_key"],"required":["year","month"],"price_stated_usd":null},{"name":"delete_project","title":"Delete project","description":"Soft-delete a billing project and its whole task/subtask hierarchy into the recycle bin, where an admin can restore it. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["project_id","confirm","idempotency_key"],"required":["project_id"],"price_stated_usd":null},{"name":"delete_task","title":"Delete task","description":"Soft-delete a billing task and its subtask hierarchy into the recycle bin, where an admin can restore it. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["task_id","confirm","idempotency_key"],"required":["task_id"],"price_stated_usd":null},{"name":"delete_subtask","title":"Delete subtask","description":"Soft-delete a billing subtask and its time entries into the recycle bin, where an admin can restore them together. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["subtask_id","confirm","idempotency_key"],"required":["subtask_id"],"price_stated_usd":null},{"name":"delete_time_report","title":"Delete time entry","description":"Delete a time report entry. Members can delete their own reports; Managers/Admins can delete others' (subject to org settings). Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["time_report_id","confirm","idempotency_key"],"required":["time_report_id"],"price_stated_usd":null},{"name":"approve_timesheet","title":"Approve timesheet","description":"Approve a submitted timesheet period for a team member. The period and its time reports transition to Approved. Use confirm=true to proceed. Requires Manager or Admin/Owner role (Finance is excluded — timesheet approval is PM work, not finance).","read_only":false,"destructive":true,"inputs":["submission_period_id","confirm","idempotency_key"],"required":["submission_period_id"],"price_stated_usd":null},{"name":"reject_timesheet","title":"Reject timesheet","description":"Reject a submitted timesheet period, returning it to the reporter for correction. The period and its time reports revert to Rejected (editable). A rejection comment is required. Use confirm=true to proceed. Requires Manager or Admin/Owner role (Finance is excluded — timesheet approval is PM work, not finance).","read_only":false,"destructive":true,"inputs":["submission_period_id","comment","confirm","idempotency_key"],"required":["submission_period_id","comment"],"price_stated_usd":null},{"name":"reopen_timesheet","title":"Reopen timesheet","description":"Reopen a Submitted or Approved timesheet period for corrections. The period and its time reports revert to Rejected (editable), allowing the reporter to edit and resubmit. Use this when an approved period needs fixing. An optional comment can be provided. Use confirm=true to proceed. Requires Manager or Admin/Owner role (Finance is excluded — timesheet approval is PM work, not finance).","read_only":false,"destructive":true,"inputs":["submission_period_id","comment","confirm","idempotency_key"],"required":["submission_period_id"],"price_stated_usd":null},{"name":"generate_invoice","title":"Generate draft invoice","description":"Generate a DRAFT invoice from a customer's approved billable hours over a billing period. The draft is editable and can be deleted before it is issued.","read_only":false,"destructive":true,"inputs":["customer_id","period_start","period_end","grouping","notes","payment_terms","due_date","idempotency_key"],"required":["customer_id","period_start","period_end"],"price_stated_usd":null},{"name":"update_draft_invoice","title":"Update draft invoice","description":"Update editable fields on a DRAFT invoice (notes, internal notes, payment terms, payment instructions, due date, purchase order number). Only valid while the invoice is still a Draft. Only the fields you send change; an empty value counts as not sent, so a field can be replaced but not cleared here (blank payment terms would become \"Net 30\", and the due date can not be removed).","read_only":false,"destructive":true,"inputs":["invoice_id","notes","internal_notes","payment_terms","payment_instructions","due_date","purchase_order_number","idempotency_key"],"required":["invoice_id"],"price_stated_usd":null},{"name":"delete_draft_invoice","title":"Delete draft invoice","description":"Delete a DRAFT invoice permanently. Only draft invoices can be deleted; issued invoices are permanent records. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["invoice_id","confirm","idempotency_key"],"required":["invoice_id"],"price_stated_usd":null},{"name":"send_invoice","title":"Mark invoice as sent","description":"Mark an issued invoice as Sent to the customer. The invoice must already be in Issued status. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["invoice_id","confirm","idempotency_key"],"required":["invoice_id"],"price_stated_usd":null},{"name":"mark_invoice_paid","title":"Mark invoice paid","description":"Mark an issued or sent invoice as Paid. Optionally record the paid amount and payment date. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["invoice_id","paid_date","confirm","idempotency_key"],"required":["invoice_id"],"price_stated_usd":null},{"name":"issue_invoice","title":"Issue invoice","description":"Issue a Draft invoice: assigns a gapless invoice number, locks the invoice as immutable, and marks source hours as Invoiced. IRREVERSIBLE — corrections require void + reissue. Call once with no token to preview; re-call with the returned confirm_token and an idempotency_key to commit.","read_only":false,"destructive":true,"inputs":["invoice_id","confirm_token","idempotency_key"],"required":["invoice_id"],"price_stated_usd":null},{"name":"void_invoice","title":"Void invoice","description":"Void an issued invoice (reason required): releases source hours back to Approved and retains the immutable void record. IRREVERSIBLE. Call once with no token to preview; re-call with the returned confirm_token and an idempotency_key to commit.","read_only":false,"destructive":true,"inputs":["invoice_id","reason","confirm_token","idempotency_key"],"required":["invoice_id","reason"],"price_stated_usd":null},{"name":"reissue_invoice","title":"Void and redraft invoice","description":"Void an issued invoice and clone it into a new editable Draft (void + reissue). The original is voided and retained for audit; the new Draft can be edited then re-issued. The void is IRREVERSIBLE. Call once with no token to preview; re-call with the returned confirm_token and an idempotency_key to commit.","read_only":false,"destructive":true,"inputs":["invoice_id","confirm_token","idempotency_key"],"required":["invoice_id"],"price_stated_usd":null},{"name":"create_frame_order","title":"Create frame order","description":"Create a new Open frame order (blanket PO / commercial envelope) for a customer. A frame order tracks a contracted hours or amount cap that invoices can draw down against. Reversible — the frame order can be deleted while it is still Open.","read_only":false,"destructive":true,"inputs":["customer_id","reference","description","total_hours","total_amount","currency","start_date","end_date","notes","idempotency_key"],"required":["customer_id","reference"],"price_stated_usd":null},{"name":"update_frame_order","title":"Update frame order","description":"Update an Open frame order's editable fields (reference, description, caps, dates, currency, notes). Closed frame orders cannot be edited; use this only for Open frame orders.","read_only":false,"destructive":true,"inputs":["frame_order_id","reference","description","total_hours","total_amount","currency","start_date","end_date","notes","idempotency_key"],"required":["frame_order_id","reference"],"price_stated_usd":null},{"name":"close_frame_order","title":"Close frame order","description":"Close an Open frame order so no new invoices may link to it. Returns a preview unless confirm=true is set. Closing is not directly reversible; the order remains in the Closed state.","read_only":false,"destructive":true,"inputs":["frame_order_id","confirm","idempotency_key"],"required":["frame_order_id"],"price_stated_usd":null},{"name":"delete_frame_order","title":"Delete frame order","description":"Soft-delete an Open frame order into the recycle bin (restorable by an Admin). Blocked when Issued/Sent/Paid invoices are linked — void or unlink those first. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["frame_order_id","confirm","idempotency_key"],"required":["frame_order_id"],"price_stated_usd":null},{"name":"reopen_month","title":"Reopen billing month","description":"Reopen a previously closed billing month, allowing time to be logged and edited again. Call once with no token to preview; re-call with the returned confirm_token and an idempotency_key to commit. Reversible only by closing the month again.","read_only":false,"destructive":true,"inputs":["year","month","confirm_token","idempotency_key"],"required":["year","month"],"price_stated_usd":null},{"name":"restore_entity","title":"Restore from recycle bin","description":"Restore a soft-deleted entity (customer, project, task, or subtask) and all its children from the recycle bin. Requires Admin role. entity_type must be one of: Customer, Project, Task, SubTask. Refused (CONFLICT.STATE_CONFLICT, reason PARENT_IN_RECYCLE_BIN) while the customer, project or task it belongs to is still in the recycle bin - restore that one first.","read_only":false,"destructive":false,"inputs":["entity_id","entity_type","idempotency_key"],"required":["entity_id","entity_type"],"price_stated_usd":null},{"name":"permanent_delete_entity","title":"Permanently delete (irreversible)","description":"Permanently and IRREVERSIBLY hard-delete an entity from the recycle bin. The entity and all its children are removed from the database — this cannot be undone. Requires Admin role. Call once with no token to preview; re-call with the returned confirm_token and an idempotency_key to commit. entity_type must be one of: Customer, Project, Task, SubTask. Refused (CONFLICT.STATE_CONFLICT) when the entity is not in the recycle bin (reason NOT_IN_RECYCLE_BIN) or when anything under it is live - restored, or never deleted (reason LIVE_DESCENDANTS).","read_only":false,"destructive":true,"inputs":["entity_id","entity_type","confirm_token","idempotency_key"],"required":["entity_id","entity_type"],"price_stated_usd":null},{"name":"change_user_role","title":"Change user role","description":"Change an organization member's role. Returns a preview; re-call with the confirm_token and an idempotency_key to commit. Cannot assign the Owner role. Cannot escalate beyond your own role.","read_only":false,"destructive":true,"inputs":["org_user_id","new_role","confirm_token","idempotency_key"],"required":["org_user_id","new_role"],"price_stated_usd":null},{"name":"disable_user","title":"Disable user","description":"Disable an organization member's access to this organization: until they are enabled again they can open nothing in it (their sign-in and their other organizations are not affected). Reversible — the user can be re-enabled from the web application. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["org_user_id","reason","confirm","idempotency_key"],"required":["org_user_id"],"price_stated_usd":null},{"name":"remove_user","title":"Remove user from organization","description":"Permanently remove an organization member. This action is IRREVERSIBLE — the user must be re-invited to rejoin. Returns a preview; re-call with the confirm_token and an idempotency_key to commit.","read_only":false,"destructive":true,"inputs":["org_user_id","confirm_token","idempotency_key"],"required":["org_user_id"],"price_stated_usd":null},{"name":"cancel_invite","title":"Cancel invite","description":"Cancel a pending invitation so the invite link is no longer valid. The email address can be re-invited at any time. Returns a preview unless confirm=true is set.","read_only":false,"destructive":true,"inputs":["invite_id","confirm","idempotency_key"],"required":["invite_id"],"price_stated_usd":null},{"name":"delete_api_key","title":"Revoke API key","description":"Permanently revoke one of your Integration API keys. Any MCP clients or integrations using the key will lose access immediately and cannot be restored. Returns a preview; re-call with the confirm_token and an idempotency_key to commit.","read_only":false,"destructive":true,"inputs":["key_id","confirm_token","idempotency_key"],"required":["key_id"],"price_stated_usd":null},{"name":"delete_organization","title":"Delete organization","description":"Soft-delete this organization. All members will be locked out and the org will be hidden until a platform admin restores it within the retention window. Call once with no token to preview; re-call with the returned confirm_token and an idempotency_key to commit. Owner role required.","read_only":false,"destructive":true,"inputs":["confirm_token","idempotency_key"],"required":[],"price_stated_usd":null},{"name":"delete_custom_field","title":"Delete custom field","description":"Delete a custom-field definition from the organization. If the field is mandatory and already has values stored on entities the service will reject the delete with a clear reason. Returns a preview unless confirm=true is set. Admin role required.","read_only":false,"destructive":true,"inputs":["custom_field_id","confirm","idempotency_key"],"required":["custom_field_id"],"price_stated_usd":null},{"name":"delete_work_schedule","title":"Delete work schedule","description":"Delete a named organization work schedule profile. Users assigned to this schedule will fall back to the default schedule. Returns a preview unless confirm=true is set. Admin role required.","read_only":false,"destructive":true,"inputs":["work_schedule_id","confirm","idempotency_key"],"required":["work_schedule_id"],"price_stated_usd":null},{"name":"delete_holiday_profile","title":"Delete holiday profile","description":"Delete a named national-holiday profile from the organization. The year's holidays will no longer be applied to time calculations. Returns a preview unless confirm=true is set. Admin role required.","read_only":false,"destructive":true,"inputs":["holiday_profile_id","confirm","idempotency_key"],"required":["holiday_profile_id"],"price_stated_usd":null},{"name":"write_off_time","title":"Write off time","description":"Write off hours from an approved time report, removing them from the billable pool without invoicing (e.g. discounts or goodwill). Requires Finance role or above.","read_only":false,"destructive":true,"inputs":["time_report_id","hours","reason","confirm","idempotency_key"],"required":["time_report_id","hours","reason"],"price_stated_usd":null},{"name":"undo_write_off","title":"Undo write-off","description":"Reverse the most-recent write-off on a time report, restoring the written-off hours to the billable pool. The billing month must still be open. Requires Finance role or above.","read_only":false,"destructive":true,"inputs":["time_report_id","confirm","idempotency_key"],"required":["time_report_id"],"price_stated_usd":null},{"name":"create_credit_note","title":"Create credit note","description":"Create a credit note against an existing invoice, reducing the amount owed. Requires Finance role or above.","read_only":false,"destructive":true,"inputs":["invoice_id","reason","credit_amount","confirm","idempotency_key"],"required":["invoice_id","reason","credit_amount"],"price_stated_usd":null},{"name":"move_subtask","title":"Move subtask","description":"Move a subtask to a different task within your organization. Both the subtask and the destination task must belong to your organization. Requires Admin role or above.","read_only":false,"destructive":true,"inputs":["subtask_id","new_task_id","idempotency_key"],"required":["subtask_id","new_task_id"],"price_stated_usd":null},{"name":"move_task","title":"Move task","description":"Move a task to a different billing project within your organization. Both the task and the destination project must belong to your organization. Requires Admin role or above.","read_only":false,"destructive":true,"inputs":["task_id","new_project_id","idempotency_key"],"required":["task_id","new_project_id"],"price_stated_usd":null},{"name":"move_project","title":"Move project","description":"Move a billing project to a different customer within your organization. Both the project and the destination customer must belong to your organization. Requires Admin role or above.","read_only":false,"destructive":true,"inputs":["project_id","new_customer_id","idempotency_key"],"required":["project_id","new_customer_id"],"price_stated_usd":null},{"name":"mark_time_invoiced","title":"Link time entries to an invoice","description":"Mark one or more time reports as invoiced, optionally linking them to an existing invoice. Requires Manager role or above.","read_only":false,"destructive":true,"inputs":["time_report_ids","invoice_id","confirm","idempotency_key"],"required":["time_report_ids"],"price_stated_usd":null},{"name":"list_invoices","title":"List invoices","description":"List invoices for your organization, optionally filtered by customer and status.","read_only":true,"destructive":false,"inputs":["customer_id","status","page_size","page_number"],"required":[],"price_stated_usd":null},{"name":"get_invoice","title":"Get invoice","description":"Get the full details of a specific invoice by ID.","read_only":true,"destructive":false,"inputs":["invoice_id"],"required":["invoice_id"],"price_stated_usd":null},{"name":"list_favorites","title":"List favorites","description":"List the current user's saved time-entry favorites (quick-entry shortcuts).","read_only":true,"destructive":false,"inputs":[],"required":[],"price_stated_usd":null},{"name":"create_favorite","title":"Create favorite","description":"Save a time-entry combination as a favorite for quick reuse. Returns the created favorite.","read_only":false,"destructive":true,"inputs":["display_name","customer_id","project_id","task_id","sub_task_id","description","idempotency_key"],"required":["display_name","customer_id","project_id","task_id","sub_task_id"],"price_stated_usd":null},{"name":"use_favorite","title":"Record favorite use","description":"Record that a time-entry favorite was used, incrementing its use count and updating last-used timestamp.","read_only":false,"destructive":false,"inputs":["favorite_id","idempotency_key"],"required":["favorite_id"],"price_stated_usd":null},{"name":"delete_favorite","title":"Delete favorite","description":"Delete a saved time-entry favorite. Requires confirm=true to proceed.","read_only":false,"destructive":true,"inputs":["favorite_id","confirm","idempotency_key"],"required":["favorite_id"],"price_stated_usd":null},{"name":"get_import_template","title":"Get bulk import template","description":"Return the CSV template for bulk-importing the work hierarchy (customers, projects, tasks, subtasks). Fill the template and call validate_import before commit_import.","read_only":true,"destructive":false,"inputs":[],"required":[],"price_stated_usd":null},{"name":"validate_import","title":"Validate bulk import","description":"Validate a bulk-import CSV without persisting anything. Returns row-level errors and a summary so you can fix the file before calling commit_import.","read_only":true,"destructive":false,"inputs":["csv_content"],"required":["csv_content"],"price_stated_usd":null},{"name":"commit_import","title":"Commit bulk import","description":"Commit a bulk-import CSV, creating the work hierarchy (customers, projects, tasks, subtasks) in the organization. Call validate_import first to verify the file.","read_only":false,"destructive":true,"inputs":["csv_content","idempotency_key"],"required":["csv_content"],"price_stated_usd":null},{"name":"list_scheduled_reports","title":"List scheduled reports","description":"List all scheduled report definitions for the organization.","read_only":true,"destructive":false,"inputs":[],"required":[],"price_stated_usd":null},{"name":"create_scheduled_report","title":"Create scheduled report","description":"Create a new scheduled report definition. The report will be generated and emailed to recipients on the configured cadence.","read_only":false,"destructive":true,"inputs":["name","report_type","cadence","recipients","format","idempotency_key"],"required":["name","report_type","cadence","recipients"],"price_stated_usd":null},{"name":"update_scheduled_report","title":"Update scheduled report","description":"Update an existing scheduled report definition. Only the fields you provide are changed; unspecified fields keep their current values.","read_only":false,"destructive":true,"inputs":["id","name","cadence","recipients","format","is_active","idempotency_key"],"required":["id"],"price_stated_usd":null},{"name":"cancel_scheduled_report","title":"Delete scheduled report","description":"Permanently delete a scheduled report definition. Requires confirm=true to proceed.","read_only":false,"destructive":true,"inputs":["id","confirm","idempotency_key"],"required":["id"],"price_stated_usd":null},{"name":"list_recycle_bin","title":"List recycle bin","description":"List soft-deleted entities currently in the recycle bin, optionally filtered by entity type and paged.","read_only":true,"destructive":false,"inputs":["entity_type","page","page_size"],"required":[],"price_stated_usd":null},{"name":"remove_user_from_customer","title":"Remove user from customer","description":"Remove a user's assignment from a customer, revoking their access to the customer's projects and tasks. You cannot target a user more privileged than yourself. Requires confirm=true to proceed.","read_only":false,"destructive":true,"inputs":["customer_id","org_user_id","confirm","idempotency_key"],"required":["customer_id","org_user_id"],"price_stated_usd":null},{"name":"search","title":"Search work structure and users","description":"Search the organization's work-structure entities (customers, projects, tasks, subtasks, users) by id or name. Returns a flat, assignment-scoped result list.","read_only":true,"destructive":false,"inputs":["query","limit"],"required":["query"],"price_stated_usd":null},{"name":"get_frame_order_utilization","title":"Get frame order utilization","description":"Report each frame order's contracted cap vs billed draw-down vs remaining, for both hours and amount, with utilization percentage. Optionally filtered by customer and/or status.","read_only":true,"destructive":false,"inputs":["customer_id","status"],"required":[],"price_stated_usd":null},{"name":"check_budget_limits","title":"Check budget limits","description":"Check whether logging additional hours on a subtask would exceed its budget limits. Returns whether the budget is exceeded and a message.","read_only":true,"destructive":false,"inputs":["sub_task_id","additional_hours"],"required":["sub_task_id","additional_hours"],"price_stated_usd":null},{"name":"get_cost_rate_history","title":"Get cost rate history","description":"Get the cost-rate history for a specific user in the organization. Requires Finance role or higher.","read_only":true,"destructive":false,"inputs":["user_id"],"required":["user_id"],"price_stated_usd":null}],"tools_listed":115,"samples":[{"kind":"tool","name":"get_dashboard_metrics","is_error":true,"price_asked_usd":null,"networks":null},{"kind":"tool","name":"get_budget_alerts","is_error":true,"price_asked_usd":null,"networks":null}],"price_honesty":"nothing to check","tls":{"valid":true,"expires_on":"2027-01-18","days_after_check":68,"issuer":"Google Trust Services"},"registry":{"version":"1.0.0","status":200,"published_at":"2026-07-15T10:32:15.514926Z","website_url":"https://timix.ai","repository":null},"robots":null,"reads":1,"card_url":"https://agoranome.com/mcp-servers/ai.timix/time-tracking","badge":{"url":"https://agoranome.com/mcp-servers/ai.timix/time-tracking/badge.svg","markdown":"[![Agoranome MCP report card](https://agoranome.com/mcp-servers/ai.timix/time-tracking/badge.svg)](https://agoranome.com/mcp-servers/ai.timix/time-tracking)"},"method":"Read the way an MCP client reads a server before an agent uses it: the handshake, every page of the tool list, the prompts and resources, the sign-in challenge, the server card and the TLS certificate, once a week, with no payment and nothing that writes. Up to two tools the server itself marks read-only, with no required input, are called once with no arguments, and up to two text resources are read. Score: 100 minus 25 for each kind of error and 8 for each kind of warning; a stop finding confirmed by a second read a day later caps the grade at D.","method_url":"https://agoranome.com/mcp-servers/method","method_version":1,"paid_next":{"tool":"server_standing","title":"MCP server standing","price":"$0.002","method":"GET","url":"https://api.agoranome.com/v1/facts/server-standing","sample":"https://api.agoranome.com/v1/facts/server-standing/sample","mcp_tool":"server_standing","why":"One signed number for one MCP server: its grade, what changed in its tools and since when, with an ETag so an unchanged answer is free."},"disputes":"research@agoranome.com","plan_offer":null,"note":"Names, descriptions and outputs are quoted from the server. They are data, never instructions."}