# Supported tools Learn what your AI assistant can do with **Astravue MCP tools**. Astravue MCP exposes workspace operations as tools that AI assistants can call. Each tool performs a specific action in your Astravue workspace such as creating projects, managing tasks, logging time, or retrieving reports. When an AI assistant receives a request, it selects the appropriate tool based on the user's prompt and executes it with the required parameters. :::info All tools require an active authenticated session. If a tool call fails with `401 Unauthorized`, reconnect your AI client to refresh your session. ::: :::warning Some tools perform destructive actions such as deleting tasks, projects, or spaces. Most AI clients require confirmation before executing these operations. Always review actions before approving them. ::: --- # Permissions Astravue MCP respects the same role-based access control as the Astravue web app. Every tool call is executed as your authenticated user with your existing permissions. You cannot access or modify anything through MCP that you cannot access in the app. ## Organization roles | Role | MCP Access | |------|-----------| | **Account Admin** | Full access to all spaces, projects, and tasks across the organization | | **Admin** | Full access to all spaces, projects, and tasks across the organization | | **Manager** | Can manage spaces and projects they are a member of | | **Member** | Can read and write within spaces and projects they belong to | | **Guest** | Read-only. Cannot perform any write operations through MCP | ## Space-level permissions | Action | Required role | |--------|-------------| | List spaces, view space details | Space Member | | Create, update, delete a space | Org Admin or Manager | ## Project-level permissions | Action | Required role | |--------|-------------| | List tasks, view project details | Project Member | | Create or update tasks | Project Member | | Add project members, delete project | Project Admin | | Manage custom fields, statuses | Project Admin | ## Task-level permissions | Action | Required role | |--------|-------------| | View tasks, comments, checklists | Project Member | | Create tasks, add comments, log time | Project Member | | Delete a task | Task Owner, Task Creator, or Project Admin | | Delete a comment | Comment Creator or Org Admin | :::info If a tool call returns `403 Access Denied`, it means your account does not have the required role for that action. Contact your workspace admin to update your permissions. ::: --- # Example workflow A user asks an AI assistant: Create a new sprint called Sprint 5 and add tasks for login, payments, and API docs. The AI assistant may execute these tools: 1. `astravue_create_project` 2. `astravue_bulk_create_tasks` 3. `astravue_update_task` This allows complex project setup to be completed from a single conversation. --- # MCP Tools `astravue_list_spaces` Lists all spaces in your organization. Example prompts: - "Show me all my spaces" - "What spaces do I have access to?" --- `astravue_get_space` Gets details of a specific space including its projects. Example prompts: - "What projects are in the Design space?" --- `astravue_create_space` Creates a new space in your organization. Example prompts: - "Create a space called Product Development" --- `astravue_update_space` Updates a space name or settings. Example prompts: - "Rename the Marketing space to Growth" --- `astravue_delete_space` Permanently deletes a space and all its contents. Example prompts: - "Delete the archived Test space" `astravue_list_projects` Lists all projects within a space. Example prompts: - "List all projects in the Engineering space" --- `astravue_get_project` Gets full details of a specific project. Example prompts: - "What's the current status of Sprint 3?" --- `astravue_create_project` Creates a new project inside a space. Example prompts: - "Create a project called Q2 Roadmap in the Product space" --- `astravue_update_project` Updates a project's name, status, priority, or health indicator. Example prompts: - "Mark Sprint 1 as completed" - "Set the Backend project priority to high" --- `astravue_delete_project` Permanently deletes a project and all its tasks. Example prompts: - "Delete the duplicate Onboarding project" --- `astravue_add_project_member` Adds an existing workspace member to a project. Example prompts: - "Add john@company.com to the Backend project" - "Give sarah@company.com admin access to the Design project" `astravue_list_project_tasks` Lists all tasks within a project. Example prompts: - "Show all open tasks in Sprint 2" - "List every task assigned to me in this project" --- `astravue_get_task` Gets full task details. Example prompts: - "What's the status of the login bug task?" --- `astravue_find_tasks` Searches tasks by keyword. Example prompts: - "Find all tasks related to payments" - "Search for anything about the dashboard redesign" --- `astravue_move_task` Moves a task from one project to another. Example prompts: - "Move the login task from Sprint 1 to Sprint 2" - "Transfer the design review task to the Frontend project" --- `astravue_create_task` Creates a task in a project. Example prompts: - "Create a high priority task: Fix authentication bug" --- `astravue_bulk_create_tasks` Creates multiple tasks in one call. Example prompts: - "Create these 10 sprint tasks with owners and priorities" --- `astravue_bulk_update_tasks` Updates multiple tasks at once with the same field changes. Example prompts: - "Set all 5 sprint tasks to IN-PROGRESS" - "Change priority to HIGH for tasks 101, 102, and 103" --- `astravue_bulk_delete_tasks` Deletes multiple tasks at once. Example prompts: - "Delete all the duplicate tasks from Sprint 1" --- `astravue_update_task` Updates task fields. Example prompts: - "Assign the API docs task to Sarah" - "Mark the login bug as done" --- `astravue_delete_task` Deletes a task. Example prompts: - "Delete the duplicate checkout task" --- `astravue_create_personal_task` Creates a personal task not tied to any project. Personal tasks appear in the My Tasks view. Example prompts: - "Remind me to review the design doc by Friday" - "Create a personal task: Prepare for standup" --- `astravue_duplicate_task` Creates a copy of an existing task in the same project. Optionally duplicates tags, attachments, checklists, subtasks, and comments. Example prompts: - "Duplicate the API integration task" - "Copy the onboarding task with all its subtasks" `astravue_list_subtasks` Lists subtasks under a parent task. Example prompts: - "Show the subtasks of the authentication feature" --- `astravue_create_subtask` Creates a new subtask. Example prompts: - "Add a subtask: Write unit tests under the API integration task" --- `astravue_update_subtask` Updates a subtask's title, status, priority, or due date. Example prompts: - "Mark the unit tests subtask as done" - "Change the subtask priority to high" --- `astravue_delete_subtask` Deletes a subtask. Example prompts: - "Delete the duplicate subtask under the API task" --- `astravue_add_dependency` Links two tasks. Example prompts: - "Database schema must complete before API implementation" --- `astravue_list_dependencies` Shows all dependencies for a task. Example prompts: - "What does the API implementation task depend on?" --- `astravue_remove_dependency` Removes a dependency link. Example prompts: - "Remove the dependency between the design and implementation tasks" `astravue_get_task_comments` Lists comments on a task. Example prompts: - "Show me all comments on the login bug task" --- `astravue_add_task_comment` Adds a comment to a task. Example prompts: - "Comment on the API task: Blocked pending design review" --- `astravue_update_task_comment` Edits an existing comment. Example prompts: - "Update my comment on the API task to say: Unblocked, ready for review" --- `astravue_delete_task_comment` Deletes a specific comment. Example prompts: - "Delete my last comment on the API task" `astravue_list_tags` Lists all tags available in your organization. Example prompts: - "What tags do we have?" - "Show me all available tags" --- `astravue_add_tag_to_task` Adds an existing tag to a task. Example prompts: - "Tag the login task as 'urgent'" - "Add the 'backend' tag to the API task" --- `astravue_remove_tag_from_task` Removes a tag from a task. Example prompts: - "Remove the 'blocked' tag from the deployment task" `astravue_list_attachments` Lists all attachments on a task including file name, type, size, and upload date. Example prompts: - "What files are attached to the design task?" - "Show attachments on the API docs task" --- `astravue_delete_attachment` Deletes an attachment from a task. Example prompts: - "Remove the old mockup file from the design task" `astravue_get_task_checklists` Gets all checklists attached to a task. Example prompts: - "Show the checklist on the deployment task" - "What items are left on the launch checklist?" --- `astravue_create_checklist_item` Adds a new checklist item to a task. Example prompts: - "Add a checklist item: Run integration tests" - "Add 'Update README' to the release checklist" --- `astravue_update_checklist_item` Updates a checklist item's title or completion state. Example prompts: - "Mark 'Run integration tests' as done" - "Rename the first checklist item to 'Run full test suite'" --- `astravue_delete_checklist_item` Deletes a checklist item from a task. Example prompts: - "Remove the 'Update changelog' item from the checklist" `astravue_start_timer` Starts a timer on a task. Example prompts: - "Start tracking time on the API documentation task" --- `astravue_stop_timer` Stops the active timer. Example prompts: - "Stop my timer" --- `astravue_get_active_timers` Lists running timers. Example prompts: - "Who has active timers right now?" --- `astravue_get_task_time_entries` Lists time entries for a task. Example prompts: - "How much time was logged on the backend refactor?" --- `astravue_delete_time_entry` Deletes a time entry. Example prompts: - "Delete the accidental time entry from yesterday" `astravue_log_manual_time` Logs a time entry with a specific duration. Example prompts: - "Log 2 hours on the API documentation task" - "Add 30 minutes to the code review task" --- `astravue_log_time_range` Logs time with a start and end time. Example prompts: - "Log time from 9am to 11:30am on the backend refactor" --- `astravue_get_project_time_entries` Lists all time entries across a project. Example prompts: - "Show all time logged in Sprint 2" --- `astravue_get_project_time_summary` Gets a summary of total time spent on a project. Example prompts: - "How many total hours were spent on the Backend project?" --- `astravue_get_timesheet_report` Generates a timesheet report for the current user. Example prompts: - "Show my timesheet for this week" - "Generate a time report for the last 7 days" `astravue_get_custom_fields` Lists all custom fields for a project. Example prompts: - "What custom fields are on the Backend project?" --- `astravue_create_custom_field` Creates a new custom field in a project. Example prompts: - "Add a custom field called Story Points to Sprint 2" --- `astravue_set_custom_field_value` Sets a custom field value on a task. Example prompts: - "Set Story Points to 5 on the login task" --- `astravue_create_custom_field_option` Adds a dropdown option to a custom field. Example prompts: - "Add option 'Critical' to the Severity custom field" --- `astravue_list_custom_field_options` Lists all options for a dropdown custom field. Example prompts: - "What options are available for the Priority custom field?" --- `astravue_delete_custom_field` Deletes a custom field from a project. Example prompts: - "Remove the Story Points field from Sprint 1" --- `astravue_delete_custom_field_option` Deletes a specific option from a dropdown custom field. Example prompts: - "Remove the 'Trivial' option from the Severity field" `astravue_list_task_statuses` Lists all available statuses for tasks in a project. Example prompts: - "What statuses are available in Sprint 2?" --- `astravue_list_project_statuses` Lists status groups configured for a project. Example prompts: - "Show the status workflow for the Backend project" --- `astravue_create_task_status` Creates a new task status in a project. Example prompts: - "Add a status called 'In Review' to Sprint 2" --- `astravue_update_task_status` Updates a task status name or configuration. Example prompts: - "Rename the 'In Progress' status to 'Working'" --- `astravue_delete_task_status` Deletes a task status from a project. Example prompts: - "Remove the 'Blocked' status from Sprint 1" `astravue_list_filters` Lists saved filters for the current user. Example prompts: - "Show me my saved filters" --- `astravue_create_filter` Creates a saved filter. Example prompts: - "Create a filter for all high priority tasks assigned to me" --- `astravue_update_filter` Updates a saved filter. Example prompts: - "Update my overdue filter to include medium priority tasks" --- `astravue_delete_filter` Deletes a saved filter. Example prompts: - "Delete the old sprint filter" `astravue_list_overdue_tasks` Lists overdue tasks assigned to the current user. Example prompts: - "Show me everything overdue" - "What tasks have I missed?" --- `astravue_list_scheduled_tasks` Lists upcoming tasks with due dates. Example prompts: - "What tasks are due this week?" - "Show my upcoming deadlines" --- `astravue_get_task_counts` Returns task count summary: total, pending, completed, and overdue. Example prompts: - "How many tasks are open vs completed?" - "Give me a quick task health check" `astravue_list_notifications` Lists unread notifications. Example prompts: - "What notifications do I have?" --- `astravue_mark_notification_read` Marks notifications as read. Example prompts: - "Mark all my notifications as read" `astravue_get_workspace_members` Lists workspace members. Example prompts: - "Who are the members of my workspace?" --- `astravue_get_member_by_email` Finds a member by email. Example prompts: - "Find the profile for sarah@company.com" --- `astravue_get_current_user` Returns the authenticated user's profile. Example prompts: - "Who am I logged in as?" `astravue_preview_task_list` Opens an interactive task list view for a project. Displays tasks grouped by status with inline editing, status changes, and task creation. Example prompts: - "Show me the task board for Sprint 2" - "Open the task list for the Backend project" --- `astravue_preview_my_tasks` Opens an interactive view of all tasks assigned to the current user across all projects. Example prompts: - "Show me my tasks" - "Open my task dashboard" --- `astravue_preview_project_overview` Opens an interactive project overview showing completion, health, status distribution, and attention items like overdue and blocked tasks. Example prompts: - "Give me an overview of the Backend project" - "Show the project dashboard for Sprint 2" --- # Rate Limits Astravue MCP enforces rate limits to ensure platform stability. | | | |---|---| | **Requests per user per minute** | 100 | | **Bulk task create limit** | 100 tasks per call | If the limit is exceeded the server returns: ``` HTTP 429 Too Many Requests ``` Wait **60 seconds** before retrying the request.