Skip to main content
Glama

Vultr MCP

by rsp2k
GitHub
Python
MIT License
1
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🌩️ 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

  1. 🍴 Fork the repository

  2. 🌿 Create a feature branch (git checkout -b feature/amazing-feature)

  3. ✍️ Make your changes

  4. ✅ Test everything (make test-parallel or make test-coverage)

  5. 📝 Commit your changes (git commit -m 'Add amazing feature')

  6. 📤 Push to the branch (git push origin feature/amazing-feature)

  7. 🎉 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
-
security - not tested
A
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.

  1. 🎯 What is Vultr MCP?
    1. ⚡ Why Choose Vultr MCP?
  2. 🛠️ Features
    1. 🌟 Core Capabilities
    2. 🎯 Enterprise Features (v2.1.0)
    3. 🏗️ Service Coverage (335+ Tools)
  3. 🚀 Quick Start
    1. 📦 Installation
    2. ⚙️ Setup with Claude Code
    3. 🎉 Start Managing!
  4. ✨ What's New in v2.1.0
    1. 🎨 Beautiful CLI Interface
    2. 📊 Performance Monitoring
    3. 📝 Structured Logging
    4. 🛡️ Enterprise Reliability
    5. 🔒 Security & Quality
  5. 💡 Examples
    1. 🗣️ Natural Language Commands
    2. 🐍 Python API
    3. 🖥️ Enterprise CLI Experience
  6. 🎯 Smart Identifier Resolution
    1. 🏷️ Before vs After
    2. 🧠 Smart Resolution Across All Services
  7. 🏗️ Architecture
    1. 📖 Documentation
      1. 🚀 Getting Started
      2. 📚 API Reference
      3. 🎓 Tutorials & Examples
    2. 🛠️ Development
      1. 🏃‍♂️ Quick Setup
      2. 📦 Build & Publish
    3. 🤝 Contributing
      1. 🚀 How to Contribute
    4. 📊 Project Stats
      1. 🙏 Acknowledgments
        1. 📄 License

          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
            21
            • Apple

          • 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 -
            13
            MIT License
            • Apple
            • Linux

          • 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

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/rsp2k/mcp-vultr'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server