> For the complete documentation index, see [llms.txt](https://docs.remote.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.remote.it/mcp-server/tools.md). # Tool Reference The tools the Remote.It MCP server exposes to your AI assistant. You normally never call these directly — the assistant chooses them based on what you ask — but knowing what's available helps you know what you can ask for. All tools operate within your account's permissions and the scopes you granted at sign-in (see [Permissions & Safety](/mcp-server/permissions-and-safety.md)). Tools marked ⚠ are destructive or execute code, and require an explicit confirmation step before they run. ## Account & context | Tool | Description | | --------------- | ---------------------------------------------------------------------------------------------------------------- | | `whoami` | Your identity, active organization, and permissions | | `graphql_query` | Read-only access to the full [GraphQL API](/developer-tools/api.md) for anything not covered by a dedicated tool | | `search_schema` | Search the GraphQL schema by keyword to discover available data | ## Devices & services | Tool | Description | | ----------------------------------- | -------------------------------------------------------------------- | | `list_devices` | List and filter devices (state, platform, tags, and more) | | `get_device` | Full detail for one device, including its services | | `get_device_sessions` | Connection history for a device — durations, bandwidth used, latency | | `claim_device` | Claim a new device by claim code | | ⚠ `delete_device` | Remove a device from your account | | `share_device` | Share a device with another Remote.It user | | `transfer_device` | Transfer device ownership to another account | | `add_service` | Add a service (SSH, HTTP, RDP, …) to a device | | `update_service` / `rename_service` | Change a service's configuration or name | | ⚠ `remove_service` | Remove a service from a device | ## Connections | Tool | Description | | ----------------------- | -------------------------------------------------------------------------------------------------- | | `open_connection` | Open a connection to a service and return the endpoint to use | | `close_connection` | Close an open connection | | `set_connect_link` | Create or update a persistent public [connect link](/features/connection-options.md) for a service | | ⚠ `remove_connect_link` | Remove a connect link | ## Organization: tags & networks | Tool | Description | | ------------------------------------------------------ | ----------------------------------------------------- | | `list_tags` / `add_tags` / `remove_tags` | View and manage device tags | | `list_networks` | List your [networks](/features/connection-options.md) | | `create_network` / `update_network` | Create or modify a network | | ⚠ `delete_network` | Delete a network | | `add_network_connection` / `remove_network_connection` | Add or remove services in a network | ## Scripting & jobs Scripting tools are only available when your account and the target devices have the Scripting permission. Executing a script always requires confirmation. See [Device Scripting](/developer-tools/device-scripting.md). | Tool | Description | | ----------------------------- | -------------------------------------------------- | | `list_scripts` / `get_script` | Browse your uploaded scripts | | `create_script` | Upload a new script | | ⚠ `run_script` | Execute a script on selected devices or tags | | `list_jobs` / `get_job` | Track script job status per device | | `get_job_logs` | Read the output a script reported from each device | | `cancel_job` | Cancel a running job | | ⚠ `delete_job` | Delete a finished job's records | ## Products (OEM & bulk provisioning) For accounts using [bulk provisioning](/oem-and-bulk-provisioning/overview.md). | Tool | Description | | ------------------------------------------------ | ---------------------------------------- | | `list_products` | List your products | | `create_product` / `update_product` | Create or modify a product definition | | ⚠ `delete_product` | Delete a product | | `transfer_product` | Transfer a product to another account | | `add_product_service` / `remove_product_service` | Manage the services a product provisions | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.remote.it/mcp-server/tools.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.