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

# MCP Server

Connect Claude, Cursor, ChatGPT, or Devin to Ornn Compute over MCP

Ornn runs a hosted [Model Context Protocol](https://modelcontextprotocol.io) server
that gives AI assistants the same capabilities as the `ornn` [CLI](/cli):
finding capacity, buying/bidding, managing reservations, activating SSH
access, reselling, and billing.

## Connect

Add this server URL to your MCP client's configuration:

```
https://mcp.ornn.com/mcp
```

Your client will prompt you to sign in with your Ornn account via OAuth and
approve the connection on the consent screen. You can revoke access at any
time from [Connected agents](https://compute.ornn.com/settings/mcp-connections).

If you change the login email on your Ornn account, existing MCP tokens are
revoked automatically as part of that security cleanup. Reconnect the agent
after the email change completes.

## Tools

| Tool                                                                                                                                                                                                                                         | Description                                                                                                                                                                                                                                                                                                       |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ornn_whoami` / `ornn_status`                                                                                                                                                                                                                | Show the signed-in user, organization, and platform status                                                                                                                                                                                                                                                        |
| `ornn_availability_list` / `ornn_availability_show`                                                                                                                                                                                          | Find GPU capacity                                                                                                                                                                                                                                                                                                 |
| `ornn_buy`                                                                                                                                                                                                                                   | Get a checkout URL to buy a listing outright (requires `confirm: true`)                                                                                                                                                                                                                                           |
| `ornn_bid_create`                                                                                                                                                                                                                            | Create a bid and get a checkout URL for it (requires `confirm: true`)                                                                                                                                                                                                                                             |
| `ornn_bid_list` / `ornn_bid_show`                                                                                                                                                                                                            | List or look up a bid                                                                                                                                                                                                                                                                                             |
| `ornn_bid_update` / `ornn_bid_withdraw`                                                                                                                                                                                                      | Change or withdraw a bid (require `confirm: true`)                                                                                                                                                                                                                                                                |
| `ornn_reservations_list` / `ornn_reservations_show`                                                                                                                                                                                          | List or look up a reservation                                                                                                                                                                                                                                                                                     |
| `ornn_reservations_checkout`                                                                                                                                                                                                                 | Get the checkout URL for a reservation already awaiting payment (requires `confirm: true`)                                                                                                                                                                                                                        |
| `ornn_access_show`                                                                                                                                                                                                                           | Show bare-metal SSH machines for a reservation                                                                                                                                                                                                                                                                    |
| `ornn_access_activate`                                                                                                                                                                                                                       | Activate access (bare-metal or VM) and launch machine(s), optionally on the private network (requires `confirm: true`)                                                                                                                                                                                            |
| `ornn_access_push_keys` / `ornn_access_keys_push`                                                                                                                                                                                            | Push SSH key(s) onto a reservation's active machines (require `confirm: true`)                                                                                                                                                                                                                                    |
| `ornn_access_keys_list` / `ornn_access_keys_add` / `ornn_access_keys_status`                                                                                                                                                                 | Manage and check SSH keys on a reservation                                                                                                                                                                                                                                                                        |
| `ornn_nodes_reboot` / `ornn_nodes_hard_reset`                                                                                                                                                                                                | Reboot or hard-reset (wipe + reboot) a reservation machine (require `confirm: true`)                                                                                                                                                                                                                              |
| `ornn_clusters_*` (`list`, `reservations`, `eligible_nodes`, `create`, `show`, `credentials`, `kubeconfig`, `add_node`, `remove_node`, `teardown`)                                                                                           | Launch and manage Kubernetes/Slurm clusters on reserved nodes (`create`, `add_node`, `remove_node`, `teardown` require `confirm: true`)                                                                                                                                                                           |
| `ornn_cluster_users_list` / `ornn_cluster_users_add` / `ornn_cluster_users_revoke`                                                                                                                                                           | Manage cluster-user SSH keys for Kubernetes/Slurm login access (`add`, `revoke` require `confirm: true`)                                                                                                                                                                                                          |
| `ornn_networks_*` (`list`, `show`, `create`, `update`, `delete`, `reservation_show`, `attach`, `detach`)                                                                                                                                     | Manage tenant-owned private networks and reservation attachments (`create`, `update`, `delete`, `attach`, `detach` require `confirm: true`)                                                                                                                                                                       |
| `ornn_vpn_peers_list` / `ornn_vpn_peers_create` / `ornn_vpn_peers_delete`                                                                                                                                                                    | Manage a reservation's WireGuard VPN peer configs (`create`, `delete` require `confirm: true`)                                                                                                                                                                                                                    |
| `ornn_storage_volumes_*` (`list`, `show`, `create`, `refresh`, `clear`, `delete`) / `ornn_storage_deploy` / `ornn_storage_filesystem_deploy` / `ornn_storage_deployment_status` / `ornn_storage_filesystem_delete` / `ornn_storage_undeploy` | Manage storage volumes (drives), managed filesystems, and reservation storage attachments (state-changing tools require `confirm: true`)                                                                                                                                                                          |
| `ornn_storage_targets`                                                                                                                                                                                                                       | List reservations eligible for a storage deploy                                                                                                                                                                                                                                                                   |
| `ornn_storage_files_ls`                                                                                                                                                                                                                      | List files on a storage volume/drive, optionally filtered by prefix                                                                                                                                                                                                                                               |
| `ornn_storage_buckets_*` (`list`, `show`, `connect`, `verify`, `update_credentials`, `disconnect`)                                                                                                                                           | Connect and manage object-storage buckets as Ornn drives (`connect`, `update_credentials`, `disconnect` require `confirm: true`)                                                                                                                                                                                  |
| `ornn_metrics_snapshot` / `ornn_metrics_history`                                                                                                                                                                                             | Read GPU health and utilization metrics for your reservation machines                                                                                                                                                                                                                                             |
| `ornn_resale_browse`                                                                                                                                                                                                                         | Browse the public resale marketplace                                                                                                                                                                                                                                                                              |
| `ornn_resale_list` / `ornn_resale_update` / `ornn_resale_delist`                                                                                                                                                                             | List, reprice, or remove a reservation on the resale marketplace (require `confirm: true`)                                                                                                                                                                                                                        |
| `ornn_ssh_keys_list` / `ornn_ssh_keys_add` / `ornn_ssh_keys_delete`                                                                                                                                                                          | Manage account-level SSH keys (delete requires `confirm: true`)                                                                                                                                                                                                                                                   |
| `ornn_billing_open`                                                                                                                                                                                                                          | Get the billing portal URL                                                                                                                                                                                                                                                                                        |
| `ornn_api`                                                                                                                                                                                                                                   | Allowlisted compute API passthrough, for anything not covered above (non-`GET` calls require `confirm: true`). Tenant-scoped resources live under `/tenants/me/...` or `/organizations/me/...` (e.g. `/tenants/me/reservations` or `/organizations/me/reservations`) — both rewrite to the same thing server-side |

Tools that spend money, mutate resale/reservation/access state, or issue a
non-`GET` `ornn_api` call require an explicit `confirm: true` argument;
without it, they return a preview of what would happen instead of executing.
Several tools that create or change something (`ornn_bid_create`, the resale
mutations) also return a follow-up URL — for example, `ornn_bid_create`
creates the bid and returns its checkout URL in the same call.
