Connect an AI agent to Vozora with MCP
Connect Claude Code, claude.ai and other MCP clients to your Vozora account with OAuth, choose what the agent may do, and disconnect it.
The Vozora MCP server lets an AI agent manage your account with the same operations as the API. It is at:
https://www.vozora.io/api/mcpThis agent will be able to spend your credit
It can create servers and other paid resources, which are charged to your prepaid credit, and it can delete servers and data. We ask agents to check with you first, but an agent is software you chose and may not always ask. You are responsible for what it does. Limit it with the permissions below, and disconnect it at any time.
An agent can only spend credit you have already added. It cannot top up, pay by card or order a monthly server: those need you, in the console.
Before you start
- A Vozora account with a verified email address.
- Credit on the account, and a saved SSH key, if you want the agent to create servers.
- A client that supports remote MCP servers over HTTP with OAuth sign-in.
How signing in works
You never paste a key. The first time the agent connects, it opens a Vozora page in your browser. Sign in if you are not already, and you see the agent's name and the permissions it is asking for. The read-only ones are ticked; tick the others you want it to have, or untick any you do not, then choose Approve.
Approve only an agent you started yourself. If a page asks you to approve an agent you were not expecting, choose Deny.
The agent then appears under Settings → Connected agents in the console, with what you allowed. It stays connected until you disconnect it there, or until it has not been used for 30 days.
Connect your client
Each client has its own way of adding a remote MCP server; give it the address above and it does the rest. These follow each client's own documentation.
Claude Code
claude mcp add --transport http vozora https://www.vozora.io/api/mcpThen run /mcp in a Claude Code session, choose vozora, and finish signing in in
your browser.
claude.ai
Open Settings → Connectors → Add custom connector, and paste:
https://www.vozora.io/api/mcpOther clients
Add a remote (HTTP) MCP server with the address above. A client that supports OAuth finds the rest for itself from:
https://www.vozora.io/.well-known/oauth-protected-resource/api/mcpA client that can only send a fixed Authorization header cannot connect: the MCP
server does not accept API keys. Use the API from such a tool instead.
Check it works
Ask the agent "what Vozora account am I connected to?". It should call account_get
and tell you your email address and what it is allowed to do.
Tools and the permission each needs
The agent is offered only the tools your approval covers. Calling any other is refused.
| Tool | Permission | What it does |
|---|---|---|
account_get | any | The account this key belongs to, the key itself and what it may do. |
billing_get | billing:read | Credit balance in pounds, what the account's hourly servers cost per hour, usage so far this month and credit history. |
plans_list | servers:read | Server sizes on sale, with their hourly price in pounds. |
images_list | servers:read | Operating system images a server can be created from. |
servers_list | servers:read | Every server in the account. |
servers_create | servers:write | Create an hourly server, paid from credit. It is returned at once in state "starting"; read it again until it is "running". The account needs credit for 24 hours of all its servers. Spends credit. |
servers_get | servers:read | One server. To connect: ssh <login_user>@<ipv4> with its SSH key, then sudo for root. There is no root password. |
servers_delete | servers:write | Delete a server and its backups for good; it answers once the server is gone (up to two minutes). A monthly server is instead set to end with its paid period, and is returned with cancel_at set. Cannot be undone. |
servers_power | servers:write | Stop, start or reboot a server. A stopped server costs the same as a running one. |
servers_resize | servers:write | Move a stopped hourly server to a larger size. A disk cannot shrink, so there is no way back down. Spends credit. |
servers_reinstall | servers:write | Replace a server's disk with a fresh operating system. Everything on it and all its backups are lost; its name, addresses and size stay. Cannot be undone. |
servers_set_firewalls | servers:write | Set which firewalls a stopped server is in. |
servers_reverse_dns_get | servers:read | The host name a server's addresses resolve back to. |
servers_reverse_dns_set | servers:write | Set the host name a server's addresses resolve back to, for mail servers. An empty name clears it. |
backups_list | servers:read | A server's backups, newest first, and whether a daily backup is on. |
backups_create | servers:write | Start a backup of a server's disk now. It appears in the list as it completes. Spends credit. |
backups_set_daily | servers:write | Turn a server's daily backup on or off. The newest seven are kept; turning it off keeps those already taken. Spends credit. |
backups_restore | servers:write | Put a stopped server's disk back to how it was when a backup was taken. Everything since is lost. Cannot be undone. |
backups_delete | servers:write | Delete one backup. Cannot be undone. |
ssh_keys_list | ssh_keys:read | Saved SSH public keys. |
ssh_keys_create | ssh_keys:write | Save an SSH public key under a name, to put on new servers. |
ssh_keys_get | ssh_keys:read | One saved SSH key. |
ssh_keys_delete | ssh_keys:write | Delete a saved SSH key. Servers already created with it keep it. Cannot be undone. |
firewalls_list | firewalls:read | Firewalls and their rules. A firewall blocks all inbound traffic that no rule allows; outbound is open. |
firewalls_create | firewalls:write | Create an empty firewall, which allows nothing in until rules are added. |
firewalls_get | firewalls:read | One firewall and its rules. |
firewalls_delete | firewalls:write | Delete a firewall no server is in. The default firewall cannot be deleted. Cannot be undone. |
firewall_rules_create | firewalls:write | Allow inbound traffic through a firewall. Takes effect at once on every server in it. |
firewall_rules_delete | firewalls:write | Remove a rule from a firewall. Cannot be undone. |
networks_list | networks:read | Private networks and the servers on them. |
networks_create | networks:write | Create a private network, with its own address range, for servers to reach each other on. Spends credit. |
networks_get | networks:read | One private network. |
networks_delete | networks:write | Delete a private network that has no servers on it. Cannot be undone. |
networks_attach | networks:write | Put a server on a private network. It gets an address there by DHCP. Can take a minute for a network's first server. |
networks_detach | networks:write | Take a server off a private network. |
volumes_list | volumes:read | Volumes: extra disks that can be moved between servers. |
volumes_create | volumes:write | Create a volume, either empty at a size in GB or holding a snapshot's contents. Spends credit. |
volumes_get | volumes:read | One volume. |
volumes_delete | volumes:write | Delete a detached volume and everything on it. Its snapshots are kept. Cannot be undone. |
volumes_attach | volumes:write | Attach a volume to a server. It appears there as a new disk to format and mount. |
volumes_detach | volumes:write | Detach a volume from its server. Unmount it inside the server first. |
snapshots_list | volumes:read | Snapshots of volumes. |
snapshots_create | volumes:write | Start a snapshot of a volume. It appears in the list as it completes. Spends credit. |
snapshots_delete | volumes:write | Delete a snapshot. Cannot be undone. |
dns_zones_list | dns:read | Domains hosted on Vozora DNS, with their records and the nameservers to point each domain at. |
dns_zones_create | dns:write | Add a domain. It answers once the domain's registrar points it at the nameservers returned; until then it is unverified. |
dns_zones_get | dns:read | One domain and its records. |
dns_zones_delete | dns:write | Delete a domain and all its records. It stops answering at once. Cannot be undone. |
dns_records_set | dns:write | Set every value of one name and type, replacing what was there. Use the name @ for the domain itself. |
dns_records_delete | dns:write | Remove every value of one name and type. Cannot be undone. |
buckets_list | storage:read | Object storage buckets, how much each holds, and the S3 endpoint to connect to. |
buckets_create | storage:write | Create a private bucket. Bucket names are shared by every customer, like domain names. Spends credit. |
buckets_get | storage:read | One bucket. |
buckets_update | storage:write | Change a bucket's size limit, versioning, or whether anyone may read and list it without a key. |
buckets_delete | storage:write | Delete a bucket and every object in it. Cannot be undone. |
storage_key_get | storage_keys:read | The S3 access key and secret for all of the account's buckets. There is none before the first bucket. |
storage_key_rotate | storage_keys:write | Replace the S3 key. The old one stops working at once. Cannot be undone. |
A server comes back with its addresses and its login_user, so an agent can tell you
the exact command to connect: ssh ubuntu@203.0.113.10, say, then sudo for root.
Keep an agent on a short lead
- Start read-only. Approve only the
:readpermissions until you trust how the agent behaves, then connect again with more. - Keep credit modest. An agent cannot add credit, and servers are stopped a day after credit runs out.
- Read before you say yes. Tools that spend credit or cannot be undone tell the agent to confirm with you first. Check the name and size of what it is about to create or delete.
- Disconnect what you no longer use, under Settings → Connected agents. It stops working at once.
Common refusals
| The agent says | Why | What to do |
|---|---|---|
missing_scope | You did not approve the permission that tool needs | Disconnect, connect again and tick it |
refused: add credit | The account lacks credit for 24 hours of its servers | Add credit in the console |
refused: stop the server first | Some changes need a stopped server | Ask the agent to stop it, then retry |
not_found | Nothing with that id in your account | Ask the agent to list first |
| No longer connected | You disconnected it, or it went unused for 30 days | Connect again |
Next
- API reference: the same operations over HTTP, with a key, for scripts and Terraform.
VPS billing, usage and invoices
Understand Vozora prepaid credit for hourly servers, monthly servers paid by card, and receipts, including why powering a server off does not stop billing.
Run Docker on Ubuntu with Nginx and HTTPS
Deploy a sample container, configure a host firewall, put Nginx and a certificate in front of it, and check it survives a reboot, on an Ubuntu 24.04 VPS.