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.
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.
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.
The button opens ChatGPT plugins in the browser. Add the server there:
### Open Add custom MCP serverIn 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 want | Tools |
|---|---|
| See who is signed in | get_identity, list_organizations, get_organization |
| Find a plan and a region | list_marketplace_offerings, get_marketplace_plan |
| See guest operating systems | list_distros |
| See SSH keys already on the account | list_ssh_keys |
| Create, start, stop, reboot, or delete a VM | create_virtual_machine, update_virtual_machine_power, delete_virtual_machine |
| Read addresses and status | list_virtual_machines, get_virtual_machine |
| Snapshots and backups | create_snapshot, list_snapshots, list_backups |
| Firewall rulesets | list_firewall_rulesets, get_firewall_ruleset |
| DNS | list_dns_zones, get_dns_zone, list_dns_records, create_dns_zone, upsert_dns_record |
| Support | list_tickets, get_ticket, create_ticket |
| Provider fleet | list_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 keyCreate 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
| Tool | Input | Returns |
|---|---|---|
get_identity | — | The signed-in user and organization |
list_organizations | — | Organizations you can see |
get_organization | id | One organization |
Marketplace and images
| Tool | Input | Returns |
|---|---|---|
list_marketplace_offerings | query (1–500 characters) | Plans with id, region_id, place, and size |
get_marketplace_plan | plan_id | One 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
| Tool | Input | Returns |
|---|---|---|
list_virtual_machines | — | Id, name, status, region, ipv4, ipv6 |
get_virtual_machine | id | The same summary for one VM |
create_virtual_machine | hostname, plan_id, region_id, distro, ssh_key_ids | Success. Read the new id from the list |
update_virtual_machine_power | id, action (start, stop, reboot) | The VM summary, including addresses |
delete_virtual_machine | id | Success. Permanent |
list_snapshots | vm_id | Snapshots for that VM |
create_snapshot | vm_id, optional description | Success |
list_backups | vm_id | Backups for that VM |
list_firewall_rulesets | — | Rule set ids and names |
get_firewall_ruleset | id | One rule set |
DNS
| Tool | Input | Returns |
|---|---|---|
list_dns_zones | — | Zones, including the nameservers to delegate |
get_dns_zone | id | One zone |
list_dns_records | zone_id | Records in that zone |
create_dns_zone | name (apex domain) | The new zone. It stays pending until the registrar delegates it |
upsert_dns_record | zone_id, name, type, content, optional ttl, allow_overwrite | The record. Types are A, AAAA, CNAME, MX, and TXT. An existing name and type is replaced only when allow_overwrite is true |
Tickets
| Tool | Input | Returns |
|---|---|---|
list_tickets | — | Your tickets |
get_ticket | id | One ticket |
create_ticket | title (10–255 characters), message (10–16384 characters) | The new ticket |
Provider fleet
These tools are offered to provider organizations.
| Tool | Input | Returns |
|---|---|---|
list_nodes | — | Nodes |
get_node | id | One node |
list_platforms | — | Platforms |
list_regions | — | Regions |