aws-messaging-mcp

A serverless Model Context Protocol server on AWS Lambda that lets Claude Code, Claude Desktop, and claude.ai Routines send email (Amazon SES), SMS/MMS (AWS End User Messaging), and share files via CloudFront-signed download links.

[!NOTE] Status: M1 (auth spike) complete on dev; prod release in progress. Tools arrive milestone by milestone; see the PRD §16, the plan, and connecting clients.

Architecture (target)

flowchart LR
    C[Claude clients] -- Bearer JWT --> W[WAF + CloudFront]
    W --> L[Lambda: Go + MCP SDK]
    L -.JWKS.-> K[Cognito]
    L --> SES[SES v2]
    L --> EUM[End User Messaging]
    L --> S3[(S3 + signed URLs)]

Full detail: docs/PRD.md §4.

Documentation

Doc	Purpose
docs/PRD.md	Source of truth: scope, architecture, auth, guardrails, milestones
docs/setup/github.md	Repository and CI/CD configuration
docs/setup/dns.md	GoDaddy → Route 53 subdomain delegation
docs/setup/aws-prerequisites.md	SES, toll-free, Cognito prerequisites
docs/tools/README.md	Tool reference, generated from the live registry
docs/testing.md	Test tiers and how to run the e2e suite
docs/plans/m0-m1.md	Current implementation plan

Development

Requires Go (version in go.mod), golangci-lint, and uv (only as a runner for the IaC scanners).

make test          # go test -race with coverage gates
make lint          # gofmt + golangci-lint
make vet           # go vet
make build         # static arm64 Lambda binary in dist/
make dev           # local server on :8000
make iac-lint      # cfn-lint + checkov + cfn_nag over infra/

See CONTRIBUTING.md for conventions (Conventional Commits, signed commits, squash-only merges).

License

MIT