NodeRings

Search and compare hosting plans, manage virtual machines, deploy one-click apps and manage GeoDNS records on NodeRings.

Hosted MCP Server

npx add-mcp 'https://mcp.noderings.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

MCP

The NodeRings Model Context Protocol server lets an assistant use your account. It can search the marketplace, create and power virtual machines, manage DNS, and open tickets. It signs in as you. It does not get a separate admin account, and it does not receive your password.

The hosted server is https://mcp.noderings.com/mcp.

Use a **client** organization to buy and operate virtual machines. A **provider** organization sees fleet tools (nodes, platforms, regions) instead of the marketplace and VM tools. Sign in again after you change organization. The session keeps the organization from the token it was given.

Connect

Any MCP client that supports Streamable HTTP and OAuth can use https://mcp.noderings.com/mcp. Cursor and ChatGPT identify themselves differently. Use the client id only in Cursor.

Cursor

In Cursor, add a remote MCP server:

{
  "mcpServers": {
    "noderings": {
      "url": "https://mcp.noderings.com/mcp",
      "auth": {
        "CLIENT_ID": "noderings-mcp"
      }
    }
  }
}

noderings-mcp is the public OAuth client for Cursor. Cursor sends that client id and opens a loopback callback on your machine.

Add to Cursor

The button installs a server named noderings with the URL and client id above. Cursor then asks you to confirm. Sign in with your NodeRings account and approve access.

ChatGPT

ChatGPT and Codex sign in as themselves. Leave the OAuth client id and client secret empty. ChatGPT sends https://chatgpt.com/oauth/client.json, and NodeRings reads the redirect URI from that document.

A connector saved with client id noderings-mcp fails with redirect_uri is not registered. Delete that connector and create a new one. Changing the URL on the old connector keeps the old client id.

Connect to ChatGPT

The button opens ChatGPT plugins in the browser. Add the server there:

### Open Add custom MCP server
In ChatGPT on the web, open Plugins, select the plus button, then **Add custom MCP server**.
### Enter the server
Name it `NodeRings`. Server URL: `https://mcp.noderings.com/mcp`. Authentication: **OAuth**. Leave client id and client secret empty.
### Approve in the browser
Accept the risk warning and create the plugin. ChatGPT opens NodeRings. Sign in and approve access. The assistant then calls the API as that user, in the organization on the token.
### Ask for something concrete
In a chat, type `@` and choose NodeRings. Start with `get_identity` or `list_virtual_machines` so you can see which account and organization the session is using.

Create, power, delete, DNS changes, and tickets are available on the hosted server. They spend money and change your account, and they run only when you ask for them. A delete still requires an explicit request.


What you can ask for

You wantTools
See who is signed inget_identity, list_organizations, get_organization
Find a plan and a regionlist_marketplace_offerings, get_marketplace_plan
See guest operating systemslist_distros
See SSH keys already on the accountlist_ssh_keys
Create, start, stop, reboot, or delete a VMcreate_virtual_machine, update_virtual_machine_power, delete_virtual_machine
Read addresses and statuslist_virtual_machines, get_virtual_machine
Snapshots and backupscreate_snapshot, list_snapshots, list_backups
Firewall rulesetslist_firewall_rulesets, get_firewall_ruleset
DNSlist_dns_zones, get_dns_zone, list_dns_records, create_dns_zone, upsert_dns_record
Supportlist_tickets, get_ticket, create_ticket
Provider fleetlist_nodes, get_node, list_platforms, list_regions

list_plans is the NodeRings subscription catalog. It is not the plan id for a virtual machine. VM plans come from list_marketplace_offerings.

Provider tools appear only for a provider organization. Marketplace and VM tools appear only for a client organization.


Order a virtual machine

### Add an SSH key
Create the key on your machine and upload the public key in [SSH Keys](https://noderings.com/orchestration/ssh-keys). `list_ssh_keys` returns the id, name, type, and fingerprint. It never returns the key.
### Search, then create
`list_marketplace_offerings` takes a short query such as "1 vcpu in Ashburn" and returns `id` (the plan) and `region_id`. `list_distros` returns the `distro` value, for example `DISTRO_UBUNTU_24_04`. `create_virtual_machine` needs the hostname, plan, region, distro, and one or more SSH key ids. It does not accept a password.
### Wait for an address
`get_virtual_machine` returns `ipv4` and `ipv6` when the platform has allocated them. A VM that is still provisioning can come back with those fields empty. Start it with `update_virtual_machine_power` (`start`, `stop`, or `reboot`) if it was created and not yet running. The same address fields are on the power response.
### SSH from your machine
The server does not open a shell and does not log in for you. On a standard OS image the selected key is installed for `root`:

```bash
ssh root@<ipv4>
```

A custom cloud-init profile can use a different user. The API does not report that user, so the tools do not invent one. See [Virtual machines](./platform/virtual-machines).

Usage-based creates require a prepaid credit balance. If the balance is short, create fails and the error states the minimum.


What it will not do

  • Run commands on the guest, open a console, or hold an SSH session.
  • Accept a root password or a pasted private key.
  • Return public key material. You match a key by name and fingerprint, then use the private key that already sits on your machine.
  • Call an arbitrary NodeRings URL. Each tool is a fixed operation.
  • Change firewall rules. It can list rulesets and read one by id.
  • Restore a backup. It can list backups and create a snapshot.

Delete a virtual machine

delete_virtual_machine removes the VM, its snapshots, and its backups, and releases its addresses. If that was the last VM on the subscription, the subscription is cancelled and a final hourly usage charge is recorded. Say which VM to delete. A second delete of the same id returns not found.


Tool reference

Account

ToolInputReturns
get_identity—The signed-in user and organization
list_organizations—Organizations you can see
get_organizationidOne organization

Marketplace and images

ToolInputReturns
list_marketplace_offeringsquery (1–500 characters)Plans with id, region_id, place, and size
get_marketplace_planplan_idOne plan and the regions it can deploy in
list_distros—Guest OS catalog. Pass distro to create
list_plans—NodeRings subscription plans, not VM plans
list_ssh_keys—Id, name, type, fingerprint

Virtual machines

ToolInputReturns
list_virtual_machines—Id, name, status, region, ipv4, ipv6
get_virtual_machineidThe same summary for one VM
create_virtual_machinehostname, plan_id, region_id, distro, ssh_key_idsSuccess. Read the new id from the list
update_virtual_machine_powerid, action (start, stop, reboot)The VM summary, including addresses
delete_virtual_machineidSuccess. Permanent
list_snapshotsvm_idSnapshots for that VM
create_snapshotvm_id, optional descriptionSuccess
list_backupsvm_idBackups for that VM
list_firewall_rulesets—Rule set ids and names
get_firewall_rulesetidOne rule set

DNS

ToolInputReturns
list_dns_zones—Zones, including the nameservers to delegate
get_dns_zoneidOne zone
list_dns_recordszone_idRecords in that zone
create_dns_zonename (apex domain)The new zone. It stays pending until the registrar delegates it
upsert_dns_recordzone_id, name, type, content, optional ttl, allow_overwriteThe record. Types are A, AAAA, CNAME, MX, and TXT. An existing name and type is replaced only when allow_overwrite is true

Tickets

ToolInputReturns
list_tickets—Your tickets
get_ticketidOne ticket
create_tickettitle (10–255 characters), message (10–16384 characters)The new ticket

Provider fleet

These tools are offered to provider organizations.

ToolInputReturns
list_nodes—Nodes
get_nodeidOne node
list_platforms—Platforms
list_regions—Regions