io.github.jasonwilbur/cloud-regions
Cloud region data for AWS, Azure, GCP, OCI & more. Query by location, compliance, GPU.
Open source Open in the app JSON README (API)
About
Cloud region data for AWS, Azure, GCP, OCI & more. Query by location, compliance, GPU.
Details
- Kind
- MCP servers
- Topic
- Cloud & DevOps
- Publisher
- jasonwilbur
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.4
- Last push
- 2026-06-03T22:48:30Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:00:14
- Updated
- 2026-08-29 04:00:14
- Origin id
io.github.jasonwilbur/cloud-regions
README
# mcp-server-cloud-regions
[](https://www.npmjs.com/package/mcp-server-cloud-regions)
[](https://www.npmjs.com/package/mcp-server-cloud-regions)
[](https://github.com/jasonwilbur/mcp-server-cloud-regions/actions/workflows/ci.yml)
[](https://opensource.org/licenses/MIT)
[](https://registry.modelcontextprotocol.io)
A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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:
- [AWS Regions](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/)
- [Azure Regions](https://learn.microsoft.com/en-us/azure/reliability/regions-list)
- [GCP Regions](https://cloud.google.com/about/locations)
- [OCI Regions](https://oracle.com/cloud/public-cloud-regions/)
- [DigitalOcean Datacenters](https://docs.digitalocean.com/platform/regional-availability/)
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:
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