Amazon EC2 Container Registry MCP Server
Amazon Elastic Container Registry (Amazon ECR) is a fully managed service provided by Amazon Web Services (AWS) that simplifies the storage, management, and deployment of container images.
Quick Start Summary
The Amazon EC2 Container Registry MCP server is a Model Context Protocol bridge that connects AI assistants — including Claude Desktop, Cursor, Windsurf, and VS Code Copilot — to the Amazon EC2 Container Registry API through natural language. It exposes 10 API endpoints as callable tools, such as BatchCheckLayerAvailability, BatchDeleteImage, BatchGetImage, and more. No authentication is required — setup takes approximately 30 seconds. The server uses STDIO transport and can be installed by running npx -y @mcp/amazonaws-com-ecr. This integration is sourced from the auto Amazon EC2 Container Registry OpenAPI specification (v2015-09-21) and has a quality score of 46/99 (fair documentation coverage).
Server Details
- Category
- Cloud Infrastructure
- Authentication
- None
- Endpoints
- 10 operations
- Transport
- STDIO
- Spec Version
- v2015-09-21
- Install Command
npx -y @mcp/amazonaws-com-ecr
Environment Variables
AMAZON_EC2_CONTAINER_REGISTRY_API_KEYExample: your_amazon_ec2_container_registry_api_key
Top Endpoints
/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.BatchCheckLayerAvailabilityBatchCheckLayerAvailability
/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.BatchDeleteImageBatchDeleteImage
/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.BatchGetImageBatchGetImage
/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.BatchGetRepositoryScanningConfigurationBatchGetRepositoryScanningConfiguration
/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.CompleteLayerUploadCompleteLayerUpload
One-Click Install
Copy the snippet for your MCP client and paste it in — zero editing required.
Claude Desktop
Add to claude_desktop_config.json
{
"mcpServers": {
"amazonaws-com-ecr": {
"command": "npx",
"args": [
"-y",
"@mcp/amazonaws-com-ecr"
],
"env": {
"AMAZON_EC2_CONTAINER_REGISTRY_API_KEY": "your_amazon_ec2_container_registry_api_key"
}
}
}
}Cursor
Settings → MCP Servers → Add
{
"mcpServers": {
"amazonaws-com-ecr": {
"url": "https://mcpbridge.org/config/amazonaws-com-ecr.json"
}
}
}Saves as .cursor/mcp.json in the download. Move it to your project root.
VS Code
Use with MCP extension
{
"mcpServers": {
"amazonaws-com-ecr": {
"url": "https://mcpbridge.org/config/amazonaws-com-ecr.json"
}
}
}Endpoints Explorer
Search and browse the 10 operations supported by this server.
Multi-Language Code Examples
Executable code snippets for calling Amazon EC2 Container Registry endpoints in curl, TypeScript, or Python.
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/ecr/2015-09-21/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.BatchCheckLayerAvailability" \ -H "Content-Type: application/json" \ # No auth required
Manual Configuration
Directly add this block to your JSON config file, or use the hosted config registry URL.
{
"mcpServers": {
"amazonaws-com-ecr": {
"command": "npx",
"args": ["-y","@mcp/amazonaws-com-ecr"],
"env": {
"AMAZON_EC2_CONTAINER_REGISTRY_API_KEY": "your_amazon_ec2_container_registry_api_key"
}
}
}
}Authentication Details
No authentication required. This MCP server runs out-of-the-box.
Documentation Links
Error Handling & HTTP Status Code Matrix
Common status codes, error causes, and resolution steps when invoking Amazon EC2 Container Registry endpoints.
400 Bad RequestCause: Malformed payload parameters or missing required fields.
Resolution: Verify request schema in Endpoints tab before calling tool.
401 UnauthorizedCause: Missing or invalid API key credentials.
Resolution: Set environment variable in MCP client config under env object.
403 ForbiddenCause: Insufficient scope permissions for requested resource.
Resolution: Verify key permissions in developer dashboard.
404 Not FoundCause: Resource URL path or requested entity ID does not exist.
Resolution: Check path variables and parameters.
429 Rate Limit ExceededCause: API rate limit quota exceeded.
Resolution: Implement exponential backoff retry in tool call.
500 Internal ErrorCause: Upstream server runtime fault.
Resolution: Inspect STDIO stderr output for log trace.
Quality Score
Checked against our protocol-compliance rules.
Specification Version: v2015-09-21
Page compiled on: June 13, 2026
Own this API?
Verify ownership of this listing to control the description, configuration details, and documentation links. Choose between free manual verification or instant premium placement.
Option 1: Free Verification
Slow manual review. Requires creating a GitHub issue with verified documentation or domain verification.
- • Verified badge on page
- • Standard search sorting
- • 2-3 business days review
Option 2: Featured Upgrade($9/mo)
Instant verification plus premium styling, featured badges, and directory placement boost.
- • ★ Featured star & amber highlight border
- • Top of directory search placement
- • Instant activation via claim token
📖 Detailed MCP Integration Guide
A technical breakdown of capabilities, agent workflows, and security/configuration best practices.
docker push command, scan an image for critical vulnerabilities before suggesting it be promoted to production, or even clean up outdated image tags based on a developer's natural language request, thereby turning high-level instructions into concrete, secure API actions and significantly reducing manual toil and cognitive load for developers.BatchGetImage and repository scanning APIs to query and report findings. Similarly, an instruction like "Create a new repository called 'auth-service' with tag immutability enabled" would have the AI translate this into a precise CreateRepository API call with the appropriate parameters. The AI could be tasked with batch operations, such as "Delete all untagged images older than 30 days in the 'staging' repository," by leveraging BatchDeleteImage in conjunction with lifecycle policy concepts. Other powerful workflows include having the AI agent automatically fetch and analyze repository scanning configurations via BatchGetRepositoryScanningConfiguration to provide a security audit, or orchestrating pull-through cache rules using CreatePullThroughCacheRule to automatically mirror public images from external registries like Docker Hub into a private ECR repository for improved reliability and speed.ecr:GetAuthorizationToken for login, ecr:BatchGetImage for reading). Developers must ensure the MCP server's credential storage is secure and that all API communication occurs over encrypted channels. Furthermore, enabling the integrated ECR vulnerability scanning and establishing lifecycle policies are essential proactive security and cost-management measures that the AI agent can be instructed to configure and monitor, creating a comprehensive and automated governance framework for container assets.Similar APIs
Other APIs in the Cloud Infrastructure category.
Supabase API
Manage Supabase projects, databases, authentication, and storage through your AI agent.
API KeyCloudflare API
Manage Cloudflare DNS, CDN, Workers, and security settings through your AI agent.
API KeyVercel API
Deploy projects, manage domains, and monitor deployments through your AI agent.
Bearer TokenDigitalOcean API
The DigitalOcean API is a comprehensive, RESTful interface provided by DigitalOcean, a leading cloud infrastructure provider focused on simplifying cloud computing for developers, startups, and enterprises. It serves as the programmatic backbone for managing the entire DigitalOcean ecosystem, enabling users to provision, configure, and control cloud resources such as Droplets (virtual private servers), Kubernetes clusters, managed databases, networks, storage volumes, and application platforms. Core capabilities include full lifecycle management of these resources, from creation and scaling to monitoring and deletion, mirroring the functionality available in the DigitalOcean control panel. Its primary use cases range from automating infrastructure setup for CI/CD pipelines and enabling infrastructure-as-code practices to supporting dynamic application scaling and resource optimization for SaaS products, e-commerce sites, and development environments. The API is designed for both developers seeking to automate their cloud operations and businesses that require programmable, scalable cloud infrastructure without the complexity of larger hyperscale providers.
Related MCP Server Integrations
Supabase API MCP Setup
Manage Supabase projects, databases, authentication, and storage through your AI agent.
Cloudflare API MCP Setup
Manage Cloudflare DNS, CDN, Workers, and security settings through your AI agent.
Vercel API MCP Setup
Deploy projects, manage domains, and monitor deployments through your AI agent.
DigitalOcean API MCP Setup
The DigitalOcean API is a comprehensive, RESTful interface provided by DigitalOcean, a leading cloud infrastructure provider focused on simplifying cloud computing for developers, startups, and enterprises. It serves as the programmatic backbone for managing the entire DigitalOcean ecosystem, enabling users to provision, configure, and control cloud resources such as Droplets (virtual private servers), Kubernetes clusters, managed databases, networks, storage volumes, and application platforms. Core capabilities include full lifecycle management of these resources, from creation and scaling to monitoring and deletion, mirroring the functionality available in the DigitalOcean control panel. Its primary use cases range from automating infrastructure setup for CI/CD pipelines and enabling infrastructure-as-code practices to supporting dynamic application scaling and resource optimization for SaaS products, e-commerce sites, and development environments. The API is designed for both developers seeking to automate their cloud operations and businesses that require programmable, scalable cloud infrastructure without the complexity of larger hyperscale providers.
Access Analyzer MCP Setup
The AWS Identity and Access Management Access Analyzer API provides a powerful, policy-as-code service that automatically identifies resources accessible from outside your AWS account or organization. At its core, the service continuously evaluates resource-based policies—such as Amazon S3 bucket policies, AWS Identity and Access Management (IAM) roles, Amazon KMS key policies, and AWS Lambda function policies—using logic-based reasoning to determine which resources grant access to unknown external principals. Its primary use case is for security and compliance teams within enterprises to proactively detect unintended data exposure, enforce least privilege principles, and audit cross-account and cross-service access. The API endpoints allow programmatic control to create, configure, and query analyzers, manage archive rules for storing findings, and generate custom policy documents, making it a foundational tool for automating cloud security posture management at scale.