io.github.jasonwilbur/cloud-regions

Official

by jasonwilbur · TypeScript

Cloud region data for AWS, Azure, GCP, OCI & more. Query by location, compliance, GPU.

Query cloud region data across AWS, Azure, GCP, OCI by location and compliance.

Topics

awsazureclaudecloudgcpmcpmcp-servermodel-context-protocolmulti-cloudoracle-cloud

README.md9 KBView on GitHub

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

json

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

With Claude Code (CLI)

bash

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:

json

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

Find the 5 nearest GPU regions to London:

json

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

List regions with 3+ availability zones:

json

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

Compare European coverage across hyperscalers:

json

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

Find government regions:

json

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

Check when data was last updated:

json

{
  "tool": "get_data_info"
}

Data Model

Each region includes:

typescript

{
  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:

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

bash

npm install mcp-server-cloud-regions

Or run directly with npx:

bash

npx -y mcp-server-cloud-regions

Contributing

Contributions welcome! To add or update provider data:

Edit provider metadata: src/data/providers.ts
Edit region data: src/data/regions-*.ts
Update metadata date: src/data/metadata.ts
Run npm run build && npm run export-data
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

Install

claude_desktop_config.json

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