{
  "markdown": "# mcp-server-cloud-regions\n\n[![npm version](https://img.shields.io/npm/v/mcp-server-cloud-regions.svg)](https://www.npmjs.com/package/mcp-server-cloud-regions)\n[![npm downloads](https://img.shields.io/npm/dm/mcp-server-cloud-regions.svg)](https://www.npmjs.com/package/mcp-server-cloud-regions)\n[![CI](https://github.com/jasonwilbur/mcp-server-cloud-regions/actions/workflows/ci.yml/badge.svg)](https://github.com/jasonwilbur/mcp-server-cloud-regions/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)\n\nA [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.\n\n**269 regions** across **14 cloud providers** — query by location, compliance, sustainability, and GPU availability.\n\n## Quick Start\n\n### With Claude Desktop\n\nAdd to your config file:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"cloud-regions\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-server-cloud-regions\"]\n    }\n  }\n}\n```\n\n### With Claude Code (CLI)\n\n```bash\nclaude mcp add cloud-regions -- npx -y mcp-server-cloud-regions\n```\n\nThen ask Claude questions like:\n- *\"Which AWS regions have H100 GPUs?\"*\n- *\"Find HIPAA-compliant regions in Europe\"*\n- *\"What's the nearest cloud region to Tokyo with GPU support?\"*\n- *\"Compare cloud provider coverage in Germany\"*\n\n## Why This Exists\n\nPlanning multi-cloud deployments requires answering questions across providers:\n\n- *\"Which providers have regions in Germany with GDPR compliance?\"*\n- *\"What's the nearest GPU-enabled region to my users in São Paulo?\"*\n- *\"Which cloud has the most coverage in Asia Pacific?\"*\n- *\"Where can I deploy with carbon-neutral infrastructure?\"*\n- *\"Which regions support FedRAMP for government workloads?\"*\n\nThis MCP server provides a unified data model to answer these questions instantly.\n\n## Supported Providers\n\n| Tier | Providers |\n|------|-----------|\n| **Hyperscalers** | AWS, Azure, GCP, Oracle Cloud (OCI) |\n| **Major** | DigitalOcean, Linode (Akamai), Vultr |\n| **Specialized** | Crusoe (clean energy), CoreWeave (GPU), Lambda Labs (AI/ML), Paperspace (GPU/ML) |\n| **Regional** | OVHcloud, Hetzner, Scaleway |\n\n## Available Tools\n\n### Discovery\n\n| Tool | Description |\n|------|-------------|\n| `list_regions` | List all regions with filtering (provider, country, compliance, GPU, sustainability, region type) |\n| `get_region` | Get detailed info for a specific region by ID (e.g., `aws-us-east-1`) |\n| `list_providers` | List all cloud providers with metadata and tier classification |\n| `get_provider_regions` | Get all regions for a specific provider |\n| `search_regions` | Full-text search across region names, cities, countries, and provider names |\n\n### Geospatial\n\n| Tool | Description |\n|------|-------------|\n| `find_nearby_regions` | Find regions nearest to coordinates (for latency optimization) |\n| `list_countries` | All countries with cloud presence and region counts |\n| `list_cities` | All cities with data centers and which providers operate there |\n\n### Specialized Queries\n\n| Tool | Description |\n|------|-------------|\n| `find_compliant_regions` | Filter by certifications (HIPAA, GDPR, FedRAMP, SOC2, PCI-DSS, etc.) |\n| `find_sustainable_regions` | Find carbon-neutral data centers |\n| `find_gpu_regions` | Find regions with GPU availability (A100, H100, TPU, etc.) |\n| `compare_provider_coverage` | Compare provider presence in a country or continent |\n\n### Analytics & Metadata\n\n| Tool | Description |\n|------|-------------|\n| `get_statistics` | Summary stats: totals by provider, country, continent, capabilities |\n| `get_data_info` | Data freshness: last updated date, version, source URLs for each provider |\n\n## Region Types\n\nThe server tracks different types of cloud regions:\n\n| Type | Description | Examples |\n|------|-------------|----------|\n| `commercial` | Standard public cloud regions | aws-us-east-1, azure-eastus |\n| `government` | Government-restricted regions (GovCloud, IL4+) | aws-us-gov-west-1, azure-usgovvirginia |\n| `sovereign` | Data sovereignty regions with separate control planes | azure-germanynorth, oci-eu-frankfurt-2 |\n| `china` | China regions (separate operators/partitions) | azure-chinaeast, aws-cn-north-1 |\n\nFilter by region type using `list_regions` with the `regionTypes` parameter.\n\n## Example Queries\n\n**Find HIPAA-compliant regions in the US:**\n```json\n{\n  \"tool\": \"find_compliant_regions\",\n  \"certifications\": [\"HIPAA\"],\n  \"countryCodes\": [\"US\"]\n}\n```\n\n**Find the 5 nearest GPU regions to London:**\n```json\n{\n  \"tool\": \"find_nearby_regions\",\n  \"latitude\": 51.5074,\n  \"longitude\": -0.1278,\n  \"limit\": 5,\n  \"hasGpu\": true\n}\n```\n\n**List regions with 3+ availability zones:**\n```json\n{\n  \"tool\": \"list_regions\",\n  \"minAvailabilityZones\": 3\n}\n```\n\n**Compare European coverage across hyperscalers:**\n```json\n{\n  \"tool\": \"compare_provider_coverage\",\n  \"continent\": \"europe\"\n}\n```\n\n**Find government regions:**\n```json\n{\n  \"tool\": \"list_regions\",\n  \"regionTypes\": [\"government\", \"sovereign\"]\n}\n```\n\n**Check when data was last updated:**\n```json\n{\n  \"tool\": \"get_data_info\"\n}\n```\n\n## Data Model\n\nEach region includes:\n\n```typescript\n{\n  id: \"aws-us-east-1\",\n  provider: \"aws\",\n  regionCode: \"us-east-1\",\n  displayName: \"US East (N. Virginia)\",\n  regionType: \"commercial\",\n  location: {\n    country: \"United States\",\n    countryCode: \"US\",\n    city: \"Ashburn\",\n    latitude: 39.0438,\n    longitude: -77.4874,\n    continent: \"north-america\"\n  },\n  availabilityZones: 6,\n  launchedDate: \"2006-08-25\",\n  status: \"ga\",\n  compliance: [\"SOC1\", \"SOC2\", \"HIPAA\", \"FedRAMP-Moderate\", \"PCI-DSS\"],\n  sustainability: {\n    renewableEnergyPercent: 100,\n    carbonNeutral: true\n  },\n  services: {\n    compute: true,\n    kubernetes: true,\n    gpu: true,\n    gpuTypes: [\"NVIDIA A10G\", \"NVIDIA A100\", \"NVIDIA H100\"]\n  },\n  sovereignty: {\n    dataResidency: \"US\",\n    dataResidencyGuarantee: true\n  }\n}\n```\n\n## Data Updates\n\nThe 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:\n\n- [AWS Regions](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/)\n- [Azure Regions](https://learn.microsoft.com/en-us/azure/reliability/regions-list)\n- [GCP Regions](https://cloud.google.com/about/locations)\n- [OCI Regions](https://oracle.com/cloud/public-cloud-regions/)\n- [DigitalOcean Datacenters](https://docs.digitalocean.com/platform/regional-availability/)\n\nA 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).\n\n## Use Cases\n\n- **Multi-cloud strategy** — Identify providers with presence in your target markets\n- **Compliance planning** — Find regions meeting regulatory requirements (HIPAA, GDPR, FedRAMP)\n- **Latency optimization** — Locate the nearest regions to your users\n- **Sustainability goals** — Deploy on carbon-neutral infrastructure\n- **GPU/AI workloads** — Find regions with specific accelerator availability\n- **Disaster recovery** — Plan geographically distributed deployments\n- **Government workloads** — Find GovCloud and sovereign regions\n\n## Installation\n\n```bash\nnpm install mcp-server-cloud-regions\n```\n\nOr run directly with npx:\n\n```bash\nnpx -y mcp-server-cloud-regions\n```\n\n## Contributing\n\nContributions welcome! To add or update provider data:\n\n1. Edit provider metadata: `src/data/providers.ts`\n2. Edit region data: `src/data/regions-*.ts`\n3. Update metadata date: `src/data/metadata.ts`\n4. Run `npm run build && npm run export-data`\n5. Submit a pull request\n\n### Scripts\n\n| Command | Description |\n|---------|-------------|\n| `npm run build` | Compile TypeScript |\n| `npm run export-data` | Export regions to `data/regions.json` |\n| `npm run check-updates` | Check if provider pages have changed |\n\n## Disclaimer\n\nThis 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.**\n\nWhile 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.\n\n## License\n\nMIT\n",
  "bytes": 8852,
  "sha": "caf016a3e0c4de38f3ffe76fcf9ac9116c9860622010c1f750955036cd61d9e1",
  "repo_slug": "jasonwilbur/mcp-server-cloud-regions",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jasonwilbur_cloud_regions_02414246/readme"
}