Provides comprehensive management of Vultr cloud infrastructure with 335+ tools across 27 service modules, including compute instances, DNS, Kubernetes clusters, databases, storage, networking, CDN, load balancers, and billing operations through natural language commands
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Vultr MCPlist my running instances in the New York region"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
๐ฉ๏ธ Vultr MCP
The Ultimate Model Context Protocol Server for Vultr Cloud Management
Transform your cloud infrastructure with natural language commands
๐ 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
Related MCP server: MCP Kubernetes Server
๐ ๏ธ 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 |
|
Bare Metal | 18 |
|
Reserved IPs | 11 | IP address |
SSH Keys | 5 |
|
Snapshots | 6 |
|
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 |
|
Load Balancers | 16 |
|
CDN & Edge | 15 | Origin/CDN domain |
Firewall | 10 |
|
Service | Tools | Smart Identifiers |
Managed Databases | 41 |
|
Block Storage | 12 |
|
Object Storage | 12 |
|
Storage Gateways | 14 |
|
Service | Tools | Smart Identifiers |
Kubernetes | 24 | Cluster |
Container Registry | 10 | Registry |
Serverless Inference | 10 | Service |
Marketplace | 11 | App name |
Service | Tools | Smart Identifiers |
Billing & Account | 12 | Account info |
Users & Subaccounts | 23 | Email, name |
Startup Scripts | 10 | Script |
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-serverThat'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 |
|
|
๐ SSH Keys |
|
|
๐ฅ Firewall Groups |
|
|
๐ธ Snapshots |
|
|
๐ Reserved IPs | IP address |
|
๐ณ Container Registries |
|
|
๐พ Block Storage |
|
|
๐ VPCs |
|
|
๐ Startup Scripts |
|
|
๐ฅ๏ธ Bare Metal |
|
|
๐ CDN Zones | Origin/CDN domain |
|
โธ๏ธ Kubernetes |
|
|
โ๏ธ Load Balancers |
|
|
๐๏ธ Databases |
|
|
๐ Object Storage |
|
|
๐ Inference Services |
|
|
๐ช Storage Gateways |
|
|
๐ฅ Subaccounts |
|
|
๐ค Users | Email address |
|
๐๏ธ 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-parallelormake 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
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.