# Terraform Setup

Install (deploy) MCP Gateway & Registry on AWS using the Terraform aws-ecs stack (ECS...

- Repository: https://github.com/agentic-community/mcp-gateway-registry (1032 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentic-community/mcp-gateway-registry --skill terraform-setup -g -a claude-code -y`
Codex: `npx skills add agentic-community/mcp-gateway-registry --skill terraform-setup -g -a codex -y`
Cursor: `npx skills add agentic-community/mcp-gateway-registry --skill terraform-setup -g -a cursor -y`
Gemini CLI: `npx skills add agentic-community/mcp-gateway-registry --skill terraform-setup -g -a gemini-cli -y`

## Description

Install (deploy) MCP Gateway & Registry on AWS using the Terraform aws-ecs stack (ECS Fargate, Aurora, DocumentDB, Keycloak). Asks whether you are running from an EC2 instance or a local laptop, confirms the required AWS IAM permissions are in place, clones the repository, bootstraps the toolchain (uv, AWS CLI, Terraform), configures terraform.tfvars, runs the two-stage terraform apply, and completes post-deployment setup. Does NOT create IAM roles itself, it tells you the permissions you need and offers to guide you through setting them up.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# MCP Gateway & Registry, Terraform (AWS ECS) Install Skill

**Repository:** https://github.com/agentic-community/mcp-gateway-registry
**This skill:** https://github.com/agentic-community/mcp-gateway-registry/blob/main/.claude/skills/terraform-setup/SKILL.md
**Full Terraform guide:** https://github.com/agentic-community/mcp-gateway-registry/blob/main/terraform/aws-ecs/README.md

## How to run this skill without cloning the repository

This skill is self-contained. You can invoke it from any directory in Claude Code. It will clone the repository for you.

```
/terraform-setup
```

Or reference it remotely if you have not installed this repo:

```
@https://raw.githubusercontent.com/agentic-community/mcp-gateway-registry/main/.claude/skills/terraform-setup/SKILL.md
```

---

## What this skill does

**`/terraform-setup`**, Guided deployment of the MCP Gateway & Registry to AWS via Terraform:
- Confirms where you are running from (EC2 instance vs. local laptop) and what that means for AWS credentials
- Confirms the AWS IAM permissions the deployment requires are in place
- Clones the MCP Gateway & Registry repository
- Bootstraps the toolchain: `uv` + `uv sync` (which provides the AWS CLI in the project venv), Terraform, and supporting tools
- Helps you configure `terraform/aws-ecs/terraform.tfvars`
- Runs `terraform apply` (a single apply in CloudFront Only mode; the two-stage certs-first flow is only needed for custom-domain mode)
- Runs the automated post-deployment setup and registers the AWS KB MCP server (the only server this skill registers)
- Ends with a complete summary of every step taken

By default the three core services (registry, auth-server, mcpgw) pull pre-built images from public ECR, so **no image build step is required**.

### AWS services / resources this deploys (tell the user up front)

Before applying, **state clearly to the user** that this stack creates and pays for the following AWS resources in their account (region `${AWS_REGION}`):

The rest: https://github.com/agentic-community/mcp-gateway-registry/blob/HEAD/.claude/skills/terraform-setup/SKILL.md