> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heliyos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tool reference

> All 73 tools the Heliyos MCP server offers, by group.

The server offers 73 tools. Every tool is named `heliyos_<resource>_<verb>` and says whether it reads, writes or is destructive, so your client can ask before it changes anything. Reads take `response_format` (`concise` or `detailed`), and lists take `limit` and `cursor`.

## Records

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_records_list`](https://docs.heliyos.ai/mcp/tools/records#heliyos-records-list) | List records | Read |
| [`heliyos_records_get`](https://docs.heliyos.ai/mcp/tools/records#heliyos-records-get) | Get a record | Read |
| [`heliyos_records_create`](https://docs.heliyos.ai/mcp/tools/records#heliyos-records-create) | Create a record | Write |
| [`heliyos_records_update`](https://docs.heliyos.ai/mcp/tools/records#heliyos-records-update) | Update a record | Write |
| [`heliyos_records_delete`](https://docs.heliyos.ai/mcp/tools/records#heliyos-records-delete) | Delete records | Destructive |
| [`heliyos_records_lookup`](https://docs.heliyos.ai/mcp/tools/records#heliyos-records-lookup) | Find records by name | Read |

## Timeline and activity

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_records_timeline`](https://docs.heliyos.ai/mcp/tools/timeline-and-activity#heliyos-records-timeline) | Read a record's timeline | Read |
| [`heliyos_records_events`](https://docs.heliyos.ai/mcp/tools/timeline-and-activity#heliyos-records-events) | Read a record's change history | Read |
| [`heliyos_interactions_list`](https://docs.heliyos.ai/mcp/tools/timeline-and-activity#heliyos-interactions-list) | List emails and meetings | Read |
| [`heliyos_interactions_get`](https://docs.heliyos.ai/mcp/tools/timeline-and-activity#heliyos-interactions-get) | Get an email or meeting | Read |

## Workspace, objects and fields

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_organization_get`](https://docs.heliyos.ai/mcp/tools/workspace-objects-and-fields#heliyos-organization-get) | Get the workspace | Read |
| [`heliyos_objects_list`](https://docs.heliyos.ai/mcp/tools/workspace-objects-and-fields#heliyos-objects-list) | List objects | Read |
| [`heliyos_objects_get`](https://docs.heliyos.ai/mcp/tools/workspace-objects-and-fields#heliyos-objects-get) | Get an object's fields | Read |
| [`heliyos_fields_create`](https://docs.heliyos.ai/mcp/tools/workspace-objects-and-fields#heliyos-fields-create) | Add a field to an object | Write |
| [`heliyos_fields_update`](https://docs.heliyos.ai/mcp/tools/workspace-objects-and-fields#heliyos-fields-update) | Change a field | Destructive |
| [`heliyos_fields_delete`](https://docs.heliyos.ai/mcp/tools/workspace-objects-and-fields#heliyos-fields-delete) | Delete a field | Destructive |

## Notes

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_notes_list`](https://docs.heliyos.ai/mcp/tools/notes#heliyos-notes-list) | List notes | Read |
| [`heliyos_notes_get`](https://docs.heliyos.ai/mcp/tools/notes#heliyos-notes-get) | Get a note | Read |
| [`heliyos_notes_create`](https://docs.heliyos.ai/mcp/tools/notes#heliyos-notes-create) | Create a note | Write |
| [`heliyos_notes_update`](https://docs.heliyos.ai/mcp/tools/notes#heliyos-notes-update) | Update a note | Write |
| [`heliyos_notes_delete`](https://docs.heliyos.ai/mcp/tools/notes#heliyos-notes-delete) | Delete a note | Destructive |

## Tasks

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_tasks_list`](https://docs.heliyos.ai/mcp/tools/tasks#heliyos-tasks-list) | List tasks | Read |
| [`heliyos_tasks_get`](https://docs.heliyos.ai/mcp/tools/tasks#heliyos-tasks-get) | Get a task | Read |
| [`heliyos_tasks_events`](https://docs.heliyos.ai/mcp/tools/tasks#heliyos-tasks-events) | Read a task's activity | Read |
| [`heliyos_tasks_create`](https://docs.heliyos.ai/mcp/tools/tasks#heliyos-tasks-create) | Create a task | Write |
| [`heliyos_tasks_update`](https://docs.heliyos.ai/mcp/tools/tasks#heliyos-tasks-update) | Update a task | Write |
| [`heliyos_tasks_delete`](https://docs.heliyos.ai/mcp/tools/tasks#heliyos-tasks-delete) | Delete a task | Destructive |
| [`heliyos_tasks_run`](https://docs.heliyos.ai/mcp/tools/tasks#heliyos-tasks-run) | Run workers on a task | Destructive |

## Scouts and signals

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_scouts_list`](https://docs.heliyos.ai/mcp/tools/scouts-and-signals#heliyos-scouts-list) | List scouts | Read |
| [`heliyos_scouts_get`](https://docs.heliyos.ai/mcp/tools/scouts-and-signals#heliyos-scouts-get) | Get a scout | Read |
| [`heliyos_scouts_create`](https://docs.heliyos.ai/mcp/tools/scouts-and-signals#heliyos-scouts-create) | Create a scout | Write |
| [`heliyos_scouts_update`](https://docs.heliyos.ai/mcp/tools/scouts-and-signals#heliyos-scouts-update) | Update a scout | Write |
| [`heliyos_scouts_delete`](https://docs.heliyos.ai/mcp/tools/scouts-and-signals#heliyos-scouts-delete) | Delete a scout | Destructive |
| [`heliyos_companies_scouts_list`](https://docs.heliyos.ai/mcp/tools/scouts-and-signals#heliyos-companies-scouts-list) | List a company's scouts | Read |
| [`heliyos_companies_scouts_add`](https://docs.heliyos.ai/mcp/tools/scouts-and-signals#heliyos-companies-scouts-add) | Add scouts to a company | Write |
| [`heliyos_companies_scouts_remove`](https://docs.heliyos.ai/mcp/tools/scouts-and-signals#heliyos-companies-scouts-remove) | Remove a company's scouts | Destructive |
| [`heliyos_signals_list`](https://docs.heliyos.ai/mcp/tools/scouts-and-signals#heliyos-signals-list) | List signals | Read |
| [`heliyos_signals_mark_read`](https://docs.heliyos.ai/mcp/tools/scouts-and-signals#heliyos-signals-mark-read) | Mark signals read | Write |

## Ask, runs and reviews

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_ask`](https://docs.heliyos.ai/mcp/tools/ask-runs-and-reviews#heliyos-ask) | Ask Heliyos | Destructive |
| [`heliyos_runs_get`](https://docs.heliyos.ai/mcp/tools/ask-runs-and-reviews#heliyos-runs-get) | Get a run | Read |
| [`heliyos_runs_list`](https://docs.heliyos.ai/mcp/tools/ask-runs-and-reviews#heliyos-runs-list) | List runs | Read |
| [`heliyos_reviews_list`](https://docs.heliyos.ai/mcp/tools/ask-runs-and-reviews#heliyos-reviews-list) | List reviews | Read |
| [`heliyos_reviews_get`](https://docs.heliyos.ai/mcp/tools/ask-runs-and-reviews#heliyos-reviews-get) | Get a review | Read |
| [`heliyos_reviews_decide`](https://docs.heliyos.ai/mcp/tools/ask-runs-and-reviews#heliyos-reviews-decide) | Approve or reject a review | Destructive |

## Workers, triggers and tools

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_workers_list`](https://docs.heliyos.ai/mcp/tools/workers-triggers-and-tools#heliyos-workers-list) | List workers | Read |
| [`heliyos_workers_get`](https://docs.heliyos.ai/mcp/tools/workers-triggers-and-tools#heliyos-workers-get) | Get a worker | Read |
| [`heliyos_workers_create`](https://docs.heliyos.ai/mcp/tools/workers-triggers-and-tools#heliyos-workers-create) | Create a worker | Write |
| [`heliyos_workers_update`](https://docs.heliyos.ai/mcp/tools/workers-triggers-and-tools#heliyos-workers-update) | Update a worker | Write |
| [`heliyos_workers_delete`](https://docs.heliyos.ai/mcp/tools/workers-triggers-and-tools#heliyos-workers-delete) | Delete a worker | Destructive |
| [`heliyos_triggers_list`](https://docs.heliyos.ai/mcp/tools/workers-triggers-and-tools#heliyos-triggers-list) | List worker triggers | Read |
| [`heliyos_workers_tools_list`](https://docs.heliyos.ai/mcp/tools/workers-triggers-and-tools#heliyos-workers-tools-list) | List tools a worker can use | Read |

## Knowledge base and files

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_knowledge_get`](https://docs.heliyos.ai/mcp/tools/knowledge-base-and-files#heliyos-knowledge-get) | Read the knowledge base | Read |
| [`heliyos_knowledge_update`](https://docs.heliyos.ai/mcp/tools/knowledge-base-and-files#heliyos-knowledge-update) | Update the knowledge base | Write |
| [`heliyos_knowledge_entries_set`](https://docs.heliyos.ai/mcp/tools/knowledge-base-and-files#heliyos-knowledge-entries-set) | Add or change a knowledge entry | Write |
| [`heliyos_knowledge_entries_delete`](https://docs.heliyos.ai/mcp/tools/knowledge-base-and-files#heliyos-knowledge-entries-delete) | Delete a knowledge entry | Destructive |
| [`heliyos_files_list`](https://docs.heliyos.ai/mcp/tools/knowledge-base-and-files#heliyos-files-list) | List files | Read |
| [`heliyos_files_get`](https://docs.heliyos.ai/mcp/tools/knowledge-base-and-files#heliyos-files-get) | Get a file | Read |
| [`heliyos_files_upload`](https://docs.heliyos.ai/mcp/tools/knowledge-base-and-files#heliyos-files-upload) | Upload a file | Write |
| [`heliyos_files_delete`](https://docs.heliyos.ai/mcp/tools/knowledge-base-and-files#heliyos-files-delete) | Delete a file | Destructive |

## Watchlist

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_watchlist_get`](https://docs.heliyos.ai/mcp/tools/watchlist#heliyos-watchlist-get) | Get the watchlist | Read |
| [`heliyos_companies_watch`](https://docs.heliyos.ai/mcp/tools/watchlist#heliyos-companies-watch) | Watch a company | Write |
| [`heliyos_companies_unwatch`](https://docs.heliyos.ai/mcp/tools/watchlist#heliyos-companies-unwatch) | Unwatch a company | Destructive |

## Labels

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_labels_list`](https://docs.heliyos.ai/mcp/tools/labels#heliyos-labels-list) | List label groups | Read |
| [`heliyos_labels_create`](https://docs.heliyos.ai/mcp/tools/labels#heliyos-labels-create) | Create a label group | Write |
| [`heliyos_labels_update`](https://docs.heliyos.ai/mcp/tools/labels#heliyos-labels-update) | Update a label group | Destructive |
| [`heliyos_labels_delete`](https://docs.heliyos.ai/mcp/tools/labels#heliyos-labels-delete) | Delete a label group | Destructive |

## Team

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_team_members_list`](https://docs.heliyos.ai/mcp/tools/team#heliyos-team-members-list) | List team members | Read |
| [`heliyos_team_members_invite`](https://docs.heliyos.ai/mcp/tools/team#heliyos-team-members-invite) | Invite a team member | Write |
| [`heliyos_team_members_remove`](https://docs.heliyos.ai/mcp/tools/team#heliyos-team-members-remove) | Remove a team member | Destructive |
| [`heliyos_team_members_change_role`](https://docs.heliyos.ai/mcp/tools/team#heliyos-team-members-change-role) | Change a team member's role | Write |

## Notification settings

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_notification_settings_get`](https://docs.heliyos.ai/mcp/tools/notification-settings#heliyos-notification-settings-get) | Get notification settings | Read |
| [`heliyos_notification_settings_update`](https://docs.heliyos.ai/mcp/tools/notification-settings#heliyos-notification-settings-update) | Update notification settings | Write |

## Usage

| Tool | What it does | Kind |
| - | - | - |
| [`heliyos_usage_get`](https://docs.heliyos.ai/mcp/tools/usage#heliyos-usage-get) | Get credit usage | Read |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.