Hostodo MCP server
Commit Oct 25, 2026Allows AI assistants to manage Hostodo VPS infrastructure, including power controls, command execution, DNS management, and support tickets.
Also known as hostodo/hostodo-mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 25, 2026
- License
- MIT
What is Hostodo MCP?
Hostodo allows AI assistants to manage Hostodo VPS infrastructure, including power controls, command execution, DNS management, and support tickets.
Summary generated from the project's README
About Hostodo MCP server
Hostodo MCP provides authenticated customers with a way to manage their VPS infrastructure through an AI assistant. The server operates via a hosted Streamable HTTP endpoint at api.hostodo.com/mcp, though a local wrapper is available for testing. Users connect by providing a developer token created in the Hostodo Console as a bearer token. The system uses scoped permissions to control access to different categories of actions.
Developers can use this interface to perform VPS operations like power controls, renaming, or reinstalling instances using OS templates. It also supports agent execution, allowing for command runs inside a VM via the QEMU guest agent and file uploads with SHA-256 verification. Beyond server management, the tool handles account tasks such as paying invoices, managing account balances, and interacting with support tickets. DNS management and SSH key administration are also included in the toolset.
What you can do with it
- 1Manage VPS power statesAsk the AI to reboot or shut down a specific virtual machine instance.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
HOSTODO_MCP_TOKEN
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablehostodo/hostodo-mcp is public and reachablegithub.com/hostodo/hostodo-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-25github.com/hostodo/hostodo-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubHostodo MCP Server
Hostodo MCP lets AI assistants and MCP-compatible clients manage Hostodo VPS infrastructure through Hostodo's hosted Streamable HTTP MCP endpoint.
- Hosted endpoint:
https://api.hostodo.com/mcp - Documentation: https://hostodo.com/docs/mcp
- Create a token: https://console.hostodo.com/settings/developer-access?tab=tokens&client=claude-code
What it can do
Hostodo MCP exposes real VPS, account, support, and DNS management tools for authenticated Hostodo customers:
VPS operations
- List owned VPS instances and capability flags
- Read detailed VM metadata
- List enabled OS templates for reinstall workflows
- Power control: start, shutdown, reboot, stop, and reset
- Rename a VPS with an explicit confirmation phrase
- Reinstall a VPS to an OS template with an explicit confirmation phrase
- View VM metrics, bandwidth usage, health checks, and incidents
- Manage snapshots where supported
Agent execution and deployments
- Enable or disable MCP/QEMU guest-agent command execution per VM
- Run bounded synchronous commands inside a VM through the QEMU guest agent
- Start, poll, read logs from, and cancel asynchronous VM commands
- Upload artifacts and install files onto owned VMs with SHA-256 verification
- Inspect deployments, service logs, rollback deployments, and restart services where available
Account and support workflows
- List invoices, inspect invoice details, and pay invoices
- List payment methods and account balance
- Apply account credit where supported
- List, create, reply to, and close support tickets
- Upload ticket attachments
DNS and access management
- List DNS zones and manage DNS records
- List and set rDNS records
- List, add, and remove SSH keys
Authentication
Create a Hostodo MCP developer token in the Hostodo Console, then send it as a bearer token:
Authorization: Bearer <hostodo_agent_token>
Tokens are scoped. Grant only the scopes your client needs:
vms:read— list VMs, view VM metadata, list OS templates, and read VM/account statevms:power— power actions, rename, reinstall, and other state-changing VM workflowsvms:exec— command execution, async commands, service operations, and artifact install workflows
Command execution is disabled by default on each VM and must be explicitly enabled per VM before exec/artifact tools can run.
Run this MCP server locally
This repository contains a small runnable MCP wrapper so registries such as Glama can start and introspect Hostodo MCP even though the production implementation lives in Hostodo's hosted API.
npm install
HOSTODO_MCP_TOKEN=<hostodo_agent_token> npm start
Docker:
docker build -t hostodo-mcp .
docker run --rm -i -e HOSTODO_MCP_TOKEN=<hostodo_agent_token> hostodo-mcp
tools/list works without a token for registry evaluation. Real tool calls require HOSTODO_MCP_TOKEN and are proxied to https://api.hostodo.com/mcp.
MCP client configuration
Use the hosted Streamable HTTP endpoint directly:
{
"mcpServers": {
"hostodo": {
"type": "http",
"url": "https://api.hostodo.com/mcp",
"headers": {
"Authorization": "Bearer <hostodo_agent_token>"
}
}
}
}
Claude Code example:
claude mcp add \
--scope user \
--transport http \
--header "Authorization: Bearer <hostodo_agent_token>" \
hostodo \
https://api.hostodo.com/mcp
Safety model
Hostodo MCP verifies token scopes and VM ownership on every request. Destructive workflows such as reinstall, rename, exec enable/disable, and power actions require explicit user intent and/or exact confirmation phrases. Command execution is per-VM opt-in.
MCP actions are audited. Audit logs are encrypted and privacy-protected: operational detail stays in Hostodo audit logs, while product analytics receive only safe metadata.
Registry metadata
This repository exists to publish Hostodo's hosted MCP server metadata for MCP registries such as Glama and the official MCP Registry. The server implementation lives in Hostodo's private OdoPanel backend.
Tool metadata is stored in src/tools.json. To refresh it from the live hosted MCP endpoint:
HOSTODO_MCP_TOKEN=<hostodo_agent_token> npm run sync-tools
Hostodo MCP questions
How do I authenticate with Hostodo MCP?
Create a Hostodo MCP developer token in the Hostodo Console and send it as a bearer token in the Authorization header.
Can I run commands inside my virtual machines?
Yes, you can run bounded synchronous commands or asynchronous VM commands through the QEMU guest agent, but command execution must be explicitly enabled per VM.
What security measures are in place for destructive actions?
Destructive workflows like reinstalling or renaming a VPS require explicit user intent or exact confirmation phrases.
How are the available token scopes organized?
Tokens are scoped into vms:read for viewing metadata, vms:power for state-changing actions, and vms:exec for command execution and deployments.