cloud-regions

mcp-server-cloud-regions

A Model Context Protocol (MCP) server providing comprehensive cloud region data across all major providers. Query, filter, and compare cloud infrastructure locations worldwide.

269 regions across 14 cloud providers — query by location, compliance, sustainability, and GPU availability.

Quick Start

With Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cloud-regions": {
      "command": "npx",
      "args": ["-y", "mcp-server-cloud-regions"]
    }
  }
}

With Claude Code (CLI)

claude mcp add cloud-regions -- npx -y mcp-server-cloud-regions

Then ask Claude questions like:

• "Which AWS regions have H100 GPUs?"
• "Find HIPAA-compliant regions in Europe"
• "What's the nearest cloud region to Tokyo with GPU support?"
• "Compare cloud provider coverage in Germany"

Why This Exists

Planning multi-cloud deployments requires answering questions across providers:

• "Which providers have regions in Germany with GDPR compliance?"
• "What's the nearest GPU-enabled region to my users in São Paulo?"
• "Which cloud has the most coverage in Asia Pacific?"
• "Where can I deploy with carbon-neutral infrastructure?"
• "Which regions support FedRAMP for government workloads?"

This MCP server provides a unified data model to answer these questions instantly.

Supported Providers

Tier	Providers
Hyperscalers	AWS, Azure, GCP, Oracle Cloud (OCI)
Major	DigitalOcean, Linode (Akamai), Vultr
Specialized	Crusoe (clean energy), CoreWeave (GPU), Lambda Labs (AI/ML), Paperspace (GPU/ML)
Regional	OVHcloud, Hetzner, Scaleway

Available Tools

Discovery

Tool	Description
list_regions	List all regions with filtering (provider, country, compliance, GPU, sustainability, region type)
get_region	Get detailed info for a specific region by ID (e.g., aws-us-east-1)
list_providers	List all cloud providers with metadata and tier classification
get_provider_regions	Get all regions for a specific provider
search_regions	Full-text search across region names, cities, countries, and provider names

Geospatial

Tool	Description
find_nearby_regions	Find regions nearest to coordinates (for latency optimization)
list_countries	All countries with cloud presence and region counts
list_cities	All cities with data centers and which providers operate there

Specialized Queries

Tool	Description
find_compliant_regions	Filter by certifications (HIPAA, GDPR, FedRAMP, SOC2, PCI-DSS, etc.)
find_sustainable_regions	Find carbon-neutral data centers
find_gpu_regions	Find regions with GPU availability (A100, H100, TPU, etc.)
compare_provider_coverage	Compare provider presence in a country or continent

Analytics & Metadata

Tool	Description
get_statistics	Summary stats: totals by provider, country, continent, capabilities
get_data_info	Data freshness: last updated date, version, source URLs for each provider

Region Types

The server tracks different types of cloud regions:

Type	Description	Examples
commercial	Standard public cloud regions	aws-us-east-1, azure-eastus
government	Government-restricted regions (GovCloud, IL4+)	aws-us-gov-west-1, azure-usgovvirginia
sovereign	Data sovereignty regions with separate control planes	azure-germanynorth, oci-eu-frankfurt-2
china	China regions (separate operators/partitions)	azure-chinaeast, aws-cn-north-1

Filter by region type using list_regions with the regionTypes parameter.

Example Queries

Find HIPAA-compliant regions in the US:

{
  "tool": "find_compliant_regions",
  "certifications": ["HIPAA"],
  "countryCodes": ["US"]
}

Find the 5 nearest GPU regions to London:

{
  "tool": "find_nearby_regions",
  "latitude": 51.5074,
  "longitude": -0.1278,
  "limit": 5,
  "hasGpu": true
}

List regions with 3+ availability zones:

{
  "tool": "list_regions",
  "minAvailabilityZones": 3
}

Compare European coverage across hyperscalers:

{
  "tool": "compare_provider_coverage",
  "continent": "europe"
}

Find government regions:

{
  "tool": "list_regions",
  "regionTypes": ["government", "sovereign"]
}

Check when data was last updated:

{
  "tool": "get_data_info"
}

Data Model

Each region includes:

{
  id: "aws-us-east-1",
  provider: "aws",
  regionCode: "us-east-1",
  displayName: "US East (N. Virginia)",
  regionType: "commercial",
  location: {
    country: "United States",
    countryCode: "US",
    city: "Ashburn",
    latitude: 39.0438,
    longitude: -77.4874,
    continent: "north-america"
  },
  availabilityZones: 6,
  launchedDate: "2006-08-25",
  status: "ga",
  compliance: ["SOC1", "SOC2", "HIPAA", "FedRAMP-Moderate", "PCI-DSS"],
  sustainability: {
    renewableEnergyPercent: 100,
    carbonNeutral: true
  },
  services: {
    compute: true,
    kubernetes: true,
    gpu: true,
    gpuTypes: ["NVIDIA A10G", "NVIDIA A100", "NVIDIA H100"]
  },
  sovereignty: {
    dataResidency: "US",
    dataResidencyGuarantee: true
  }
}

Data Updates

The server automatically fetches the latest region data from GitHub on startup, with fallback to bundled data if offline. Data is verified against official provider documentation:

• AWS Regions
• Azure Regions
• GCP Regions
• OCI Regions
• DigitalOcean Datacenters

A weekly GitHub Action checks the provider pages for changes and opens an issue when an update may be needed; the region data is then refreshed and released by a maintainer (the dataset itself is curated, not auto-generated from the provider pages).

Use Cases

• Multi-cloud strategy — Identify providers with presence in your target markets
• Compliance planning — Find regions meeting regulatory requirements (HIPAA, GDPR, FedRAMP)
• Latency optimization — Locate the nearest regions to your users
• Sustainability goals — Deploy on carbon-neutral infrastructure
• GPU/AI workloads — Find regions with specific accelerator availability
• Disaster recovery — Plan geographically distributed deployments
• Government workloads — Find GovCloud and sovereign regions

Installation

npm install mcp-server-cloud-regions

Or run directly with npx:

npx -y mcp-server-cloud-regions

Contributing

Contributions welcome! To add or update provider data:

1. Edit provider metadata: src/data/providers.ts
2. Edit region data: src/data/regions-*.ts
3. Update metadata date: src/data/metadata.ts
4. Run npm run build && npm run export-data
5. Submit a pull request

Scripts

Command	Description
npm run build	Compile TypeScript
npm run export-data	Export regions to data/regions.json
npm run check-updates	Check if provider pages have changed

Disclaimer

This data is provided for informational purposes only. Cloud providers frequently add, modify, or deprecate regions and services. Users are responsible for verifying region availability, compliance certifications, and service offerings directly with each cloud provider before making deployment decisions.

While we strive to keep this data accurate and up-to-date, we make no guarantees about completeness or correctness. Always consult official provider documentation for production planning.

License

MIT