🌩️ Vultr MCP

The Ultimate Model Context Protocol Server for Vultr Cloud Management

Transform your cloud infrastructure with natural language commands

Python 3.10+ PyPI version License: MIT MCP Compatible Downloads

🚀 Quick Start • 📖 Documentation • 🛠️ Features • 💡 Examples • 🤝 Contributing

🎯 What is Vultr MCP?

Vultr MCP is the most comprehensive Model Context Protocol server for Vultr cloud services, bringing 335+ management tools across 27 service modules to your fingertips. Manage your entire Vultr infrastructure through natural language conversations with Claude Code, Claude Desktop, or any MCP-compatible AI assistant.

⚡ Why Choose Vultr MCP?

🎛️ Complete Control: Manage every aspect of your Vultr infrastructure
🧠 AI-Native: Built specifically for natural language cloud management
🔍 Smart Identifiers: Use human names instead of cryptic UUIDs
🚀 Enterprise Ready: Battle-tested with comprehensive error handling
🌐 Full Coverage: From DNS to Kubernetes, databases to CDN
✨ Beautiful CLI: Professional Rich UI with colors, tables, and real-time feedback

🛠️ Features

🌟 Core Capabilities

🎯 Smart Management

🔤 Human-readable identifiers
🛡️ Intelligent validation
📊 Real-time analytics
🔄 Bulk operations

⚡ Developer Experience

🐍 Native Python API
🖥️ Rich CLI interface
📚 Comprehensive docs
🧪 Full test coverage

🎯 Enterprise Features (v2.1.0)

🎨 Beautiful CLI Interface

🌈 Rich colors and professional tables
📊 Real-time performance metrics
🔄 Loading spinners and progress bars
✨ Branded panels and status indicators

📝 Structured Logging

🏷️ Contextual logging with service tags
⏱️ Request timing and performance data
🔍 Debug-level API call tracing
📊 Error tracking with retry attempts

⚡ Performance & Reliability

💾 Intelligent TTL-based caching (85%+ hit rate)
🔄 Exponential backoff retry with jitter
📈 Real-time P95/P99 performance monitoring
🛡️ Network timeout and error resilience

🔒 Security & Quality

🛡️ Pre-commit hooks with 7 quality checks
🔍 Bandit security scanning
🤖 Dependabot automated updates
⚡ Ruff lightning-fast linting

🏗️ Service Coverage (335+ Tools)

Service	Tools	Smart Identifiers
Instances	14	`label` , `hostname`
Bare Metal	18	`label` , `hostname`
Reserved IPs	11	IP address
SSH Keys	5	`name`
Snapshots	6	`description`
Backups	2	UUID
Regions	5	Region code
Plans	10	Plan ID

Service	Tools	Smart Identifiers
DNS Management	14	Domain name
VPCs & VPC 2.0	15	`description`
Load Balancers	16	`name` , `label`
CDN & Edge	15	Origin/CDN domain
Firewall	10	`description`

Service	Tools	Smart Identifiers
Managed Databases	41	`name` , `label`
Block Storage	12	`label`
Object Storage	12	`name` , `label`
Storage Gateways	14	`name` , `label`

Service	Tools	Smart Identifiers
Kubernetes	24	Cluster `name` / `label`
Container Registry	10	Registry `name`
Serverless Inference	10	Service `name` / `label`
Marketplace	11	App name

Service	Tools	Smart Identifiers
Billing & Account	12	Account info
Users & Subaccounts	23	Email, name
Startup Scripts	10	Script `name`
ISO Images	7	Filename
Operating Systems	8	OS name

🚀 Quick Start

📦 Installation

# 🏃‍♂️ Fast installation with uv (recommended) uv add mcp-vultr # 📦 Traditional pip installation pip install mcp-vultr

⚙️ Setup with Claude Code

# 🔑 Set your Vultr API key export VULTR_API_KEY="your-vultr-api-key" # 🔌 Add to Claude Code (one command!) claude mcp add vultr vultr-mcp-server --env VULTR_API_KEY="${VULTR_API_KEY}"

🎉 Start Managing!

# 🚀 Launch the MCP server vultr-mcp-server

That's it! You now have 335+ Vultr management tools available through natural language in Claude Code.

✨ What's New in v2.1.0

🎉 MAJOR ENTERPRISE UPGRADE - Complete transformation with professional-grade features:

🎨 Beautiful CLI Interface

Rich Tables: Professional colored tables with borders and status indicators
Branded Panels: Stunning server startup with custom panels and emojis
Loading Feedback: Spinners, progress bars, and real-time status updates
Error Styling: Graceful error handling with contextual formatting

📊 Performance Monitoring

Real-time Metrics: P95/P99 response times, cache hit rates, error tracking
Intelligent Caching: TTL-based caching with 85%+ hit rates for faster responses
System Monitoring: CPU, memory, network, and disk I/O tracking
Performance Tables: Beautiful metrics visualization with trend analysis

📝 Structured Logging

Context-Rich Logs: Service tags, request timing, and correlation IDs
Debug Tracing: Full API call tracing with request/response details
Error Tracking: Retry attempts, failure analysis, and recovery metrics
JSON Support: Machine-readable logs for log aggregation systems

🛡️ Enterprise Reliability

Exponential Backoff: Smart retry logic with jitter to prevent thundering herd
Network Resilience: Timeout protection and connection pooling
Error Recovery: Graceful degradation and automatic failover
Rate Limit Handling: Intelligent backoff when approaching API limits

🔒 Security & Quality

Pre-commit Hooks: Automated code quality checks on every commit
Security Scanning: Bandit security analysis and vulnerability detection
Dependency Management: Automated updates with Dependabot
Modern Tooling: Lightning-fast Ruff linting with comprehensive rule sets

💡 Examples

🗣️ Natural Language Commands

🧑‍💻 "Create a web server instance called 'my-website' in New Jersey" 🤖 ✅ Created instance 'my-website' (Ubuntu 22.04, 1GB RAM) in ewr region 🧑‍💻 "Add a DNS record for blog.example.com pointing to my-website" 🤖 ✅ Added A record: blog.example.com → 192.168.1.100 (TTL: 300) 🧑‍💻 "Scale my Kubernetes cluster to 5 nodes" 🤖 ✅ Scaled cluster 'production' node pool to 5 nodes 🧑‍💻 "Show me this month's billing breakdown by service" 🤖 📊 Monthly costs: Instances $45, Kubernetes $120, Storage $23...

🐍 Python API

import asyncio from mcp_vultr import VultrDNSClient, VultrDNSServer async def deploy_website(): """🚀 Deploy a complete website infrastructure""" # High-level DNS client dns = VultrDNSClient("your-api-key") # Full API client with smart identifiers vultr = VultrDNSServer("your-api-key") # 🌐 Create domain and DNS records await dns.create_domain("mysite.com", "192.168.1.100") await dns.add_a_record("mysite.com", "www", "192.168.1.100") await dns.add_mx_record("mysite.com", "@", "mail.mysite.com", 10) # 🖥️ Deploy instance with smart naming instance = await vultr.create_instance( region="ewr", plan="vc2-1c-1gb", os_id=387, label="web-server", # 🏷️ Human-readable name! hostname="web.mysite.com" ) # 🔥 Configure firewall by description firewall = await vultr.get_firewall_group("web-servers") # 📊 Get real-time metrics stats = await vultr.get_instance_bandwidth("web-server") # By name! print(f"✅ Deployed {instance['label']} with {stats['incoming']}GB traffic") asyncio.run(deploy_website())

🖥️ Enterprise CLI Experience

✨ Beautiful Rich Interface with Professional Tables

# 🌈 Stunning domain overview with colors and status indicators $ mcp-vultr domains list Vultr DNS Domains (49 found) ┏━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┓ ┃ Domain ┃ Created ┃ DNSSEC ┃ ┡━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━┩ │ api.mycompany.com │ 2024-01-15T10:30:00+00:00 │ ✅ enabled │ │ webapp.io │ 2024-03-22T14:20:00+00:00 │ ❌ disabled │ │ blog.example.com │ 2024-07-10T09:15:00+00:00 │ ✅ enabled │ └─────────────────────────┴───────────────────────────┴─────────────┘ # 🚀 Professional server startup with branded panels $ mcp-vultr server ╭────────────────────────────── Vultr MCP Server ──────────────────────────────╮ │ 🚀 Starting Vultr DNS MCP Server │ │ 🔑 API Key: your-key-abc123... │ │ 🔄 Press Ctrl+C to stop │ ╰──────────────────────────────────────────────────────────────────────────────╯ # 🏗️ Infrastructure management with smart names mcp-vultr instances create --label "api-server" --region ewr --plan vc2-2c-4gb mcp-vultr instances start api-server # Start by name! mcp-vultr instances attach-volume api-server db-storage # Attach by names! # 🌐 DNS management with real-time feedback mcp-vultr domains create api.mycompany.com 192.168.1.200 mcp-vultr records add api.mycompany.com A @ 192.168.1.200 mcp-vultr setup-website api.mycompany.com 192.168.1.200 --ssl # 🐳 Kubernetes cluster management mcp-vultr k8s create production-cluster --region ewr --nodes 3 mcp-vultr k8s scale production-cluster --nodes 5 # Scale by name! mcp-vultr k8s get-costs production-cluster # Cost analysis!

📊 Real-time Performance Monitoring & Structured Logging

# 📈 Live performance metrics and cache statistics [info] API request completed method=GET response_time=0.63s status_code=200 [debug] Cache set cache_type=TTLCache endpoint=/domains hit_rate=85.2% [debug] API call recorded cache_hit=False duration=0.63s success=True # 📊 Beautiful performance tables with P95/P99 metrics API Performance Metrics ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━┓ ┃ Endpoint ┃ Requests ┃ Avg Time ┃ P95 ┃ Cache Hit ┃ Error Rate ┃ ┡━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━┩ │ GET /domains │ 1,247 │ 0.234s │ 0.456s │ 85.2% │ 0.1% │ │ GET /records │ 3,891 │ 0.189s │ 0.312s │ 92.1% │ 0.3% │ │ POST /records │ 456 │ 0.567s │ 1.234s │ 0.0% │ 2.1% │ └───────────────┴──────────┴──────────┴────────┴───────────┴────────────┘

🎯 Smart Identifier Resolution

Stop wrestling with UUIDs! Vultr MCP's killer feature is smart identifier resolution - use human-readable names instead of cryptic UUIDs across all services.

🏷️ Before vs After

# 😤 The old way (UUIDs everywhere) vultr instance stop cb676a46-66fd-4dfb-b839-443f2e6c0b60 vultr firewall rule add 5f2a4b6c-7b8d-4e9f-a1b2-3c4d5e6f7a8b --port 443 # 🎉 The Vultr MCP way (human names!) mcp-vultr instances stop web-server mcp-vultr firewall rules add web-servers --port 443

🧠 Smart Resolution Across All Services

Service

Smart Identifier

Example

🖥️

Instances

label

hostname

web-server

api.company.com

🔑

SSH Keys

name

laptop-key

ci-deploy-key

🔥

Firewall Groups

description

web-servers

database-tier

📸

Snapshots

description

backup-2024-01

pre-upgrade

🌐

Reserved IPs

IP address

192.168.1.100

🐳

Container Registries

name

my-app-registry

💾

Block Storage

label

database-storage

🌐

VPCs

description

production-network

📜

Startup Scripts

name

docker-setup

🖥️

Bare Metal

label

hostname

db-server-01

🌐

CDN Zones

Origin/CDN domain

cdn.mysite.com

☸️

Kubernetes

name

label

prod-cluster

⚖️

Load Balancers

name

label

api-lb

🗄️

Databases

name

label

postgres-main

💎

Object Storage

name

label

media-bucket

🚀

Inference Services

name

label

ml-api

🚪

Storage Gateways

name

label

file-gateway

👥

Subaccounts

name

email

dev-team

👤

Users

Email address

admin@company.com

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐ │ 🤖 AI Assistant │ │ (Claude Code/Desktop) │ └──────────────────────────┬──────────────────────────────────────┘ │ Natural Language Commands ┌──────────────────────────▼──────────────────────────────────────┐ │ 📡 Vultr MCP Server │ │ (335+ Tools) │ ├─────────────────────────────────────────────────────────────────┤ │ 🌐 DNS 🖥️ Compute 🐳 K8s 🗄️ DB 🔥 Security 💾 Storage │ │ 📊 Analytics 🌍 CDN ⚖️ LB 🚀 Serverless 👥 Users │ └──────────────────────────┬──────────────────────────────────────┘ │ Smart API Calls ┌──────────────────────────▼──────────────────────────────────────┐ │ ☁️ Vultr Cloud API │ │ (Complete Infrastructure Management) │ └─────────────────────────────────────────────────────────────────┘

📖 Documentation

🚀 Getting Started

📚 API Reference

🎓 Tutorials & Examples

🛠️ Development

🏃‍♂️ Quick Setup

# 📥 Clone the repository git clone https://git.supported.systems/MCP/mcp-vultr.git cd mcp-vultr # ⚡ Install with uv (recommended) uv sync --extra dev # 🧪 Run tests (multiple performance modes) make test-fast # ⚡ Quick tests (30-60s) make test-parallel # 🚀 Parallel execution (60-120s) make test-coverage # 📊 Full coverage (180-300s) # 🎯 Targeted testing make test-unit # Unit tests only make test-mcp # MCP server tests make test-error # Error handling tests # 📈 Performance monitoring python test_performance_benchmark.py # 🎨 Format code uv run black src tests && uv run isort src tests # 🔍 Type checking uv run mypy src

📦 Build & Publish

# 🏗️ Build package uv build # ✅ Check integrity uv run twine check dist/* # 🚀 Publish to PyPI uv run twine upload dist/*

🤝 Contributing

We ❤️ contributions! Whether it's:

🐛 Bug Reports: Found an issue? Let us know!
✨ Feature Requests: Have ideas? We want to hear them!
📝 Documentation: Help make our docs even better
🧪 Testing: Add tests, improve coverage
💻 Code: Submit PRs for new features or fixes

🚀 How to Contribute

🍴 Fork the repository
🌿 Create a feature branch (git checkout -b feature/amazing-feature)
✍️ Make your changes
✅ Test everything (make test-parallel or make test-coverage)
📝 Commit your changes (git commit -m 'Add amazing feature')
📤 Push to the branch (git push origin feature/amazing-feature)
🎉 Open a Pull Request

📊 Project Stats

Metric	Value
🛠️ MCP Tools	335+
📦 Service Modules	27
🐍 Python Support	3.10+
📈 Test Coverage	90%+
📚 Documentation	Comprehensive
⚡ Performance	Production Ready

🙏 Acknowledgments

🌩️ Vultr for their comprehensive cloud API
🤖 Anthropic for the Model Context Protocol specification
🐍 Python Community for amazing tools and libraries
🚀 FastMCP for the excellent MCP framework
👥 Contributors who make this project amazing

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⭐ Star us on

Made with ❤️ for the cloud infrastructure community

🚀 Get Started • 📖 Documentation • 🐛 Report Issues • 💬 Discussions

Deploy Server

HTTP connection URL

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Enables complete Vultr cloud infrastructure management through natural language commands, providing 335+ tools across 27 services including compute, DNS, Kubernetes, databases, and networking. Features smart identifier resolution allowing users to reference resources by human-readable names instead of UUIDs.

Related MCP Servers

GCP MCP
henihaddad
A
security
F
license
A
quality
Enables managing Google Cloud Platform resources through natural language commands in Claude Desktop, supporting comprehensive operations across compute, storage, databases, networking, monitoring, and IAM without manual credential setup.
Last updated -
56
20
MCP Kubernetes Server
abhijeetka
A
security
F
license
A
quality
A server that enables LLMs to manage Kubernetes clusters through natural language commands, wrapping kubectl operations to provide a simplified interface for common Kubernetes tasks.
Last updated -
25
9
Superjolt MCP Server
scoritz
-
security
A
license
-
quality
Enables AI-powered infrastructure management of JavaScript applications via natural language commands, allowing users to deploy, configure, and manage cloud services through Claude Desktop.
Last updated -
4
MIT License
OCI MCP Server
GoCoder7
A
security
F
license
A
quality
Enables interaction with Oracle Cloud Infrastructure services through a unified interface. Supports comprehensive OCI resource management including compute instances, storage, networking, databases, and monitoring through natural language commands in VS Code.
Last updated -
1

View all related MCP servers

Appeared in Searches

MCP servers for IT administration tasks

🌩️ Vultr MCP

🎯 What is Vultr MCP?

⚡ Why Choose Vultr MCP?

🛠️ Features

🌟 Core Capabilities

🎯 Enterprise Features (v2.1.0)

🏗️ Service Coverage (335+ Tools)

🚀 Quick Start

📦 Installation

⚙️ Setup with Claude Code

🎉 Start Managing!

✨ What's New in v2.1.0

🎨 Beautiful CLI Interface

📊 Performance Monitoring

📝 Structured Logging

🛡️ Enterprise Reliability

🔒 Security & Quality

💡 Examples

🗣️ Natural Language Commands

🐍 Python API

🖥️ Enterprise CLI Experience

🎯 Smart Identifier Resolution

🏷️ Before vs After

🧠 Smart Resolution Across All Services

🏗️ Architecture

📖 Documentation

🚀 Getting Started

📚 API Reference

🎓 Tutorials & Examples

🛠️ Development

🏃‍♂️ Quick Setup

📦 Build & Publish

🤝 Contributing

🚀 How to Contribute

📊 Project Stats

🙏 Acknowledgments

📄 License

Tools

Related MCP Servers

GCP MCP

MCP Kubernetes Server

Superjolt MCP Server

OCI MCP Server

Appeared in Searches

New MCP Servers

MCP directory API