Listing Container-based AI agent products
Managing container-based AI agents and tools
Container-based AI agents and tools running on Amazon Bedrock AgentCore Runtime can be managed through the unified AI agents and tools products page or the Server products page in the AWS Marketplace Management Console. Only products with versions that support Amazon Bedrock AgentCore Runtime will be visible in the AI agents and tools product page.
Start the listing wizard
-
Sign in to the AWS Marketplace Management Portal
with your AWS seller account. -
Select Products and then select AI Agents and Tools in the navigation bar.
-
Select the Create AI Agents and Tools product menu, then choose Container-based AI agents & tools.
-
Select Generate product ID and product code.
(Optional) Add tags to support tag-based authorization.
-
Select Continue.
Step 1: Provide product Information
-
In Product information, enter:
-
Product title
-
Product logo S3 URL
-
Short description
-
Long description
-
Highlight (1-3)
-
-
Enter support details and add optional learning resources by choosing Add resource.
-
In the Product categories menu, choose 1-3 categories. We recommend that you choose at least one category from the AI Agents & Tools business categories.
-
Enter keywords to improve search discoverability.
-
(Optional) Add video and image assets according to the guidelines.
-
Choose Next.
Step 2: Configure AI Agent Container pricing
-
Choose pricing model.
AgentCore pricing limitations
If the container image utilizes AgentCore, the Hourly and Usage with long-term contract pricing models are not supported. To learn more about contract pricing, see Contract pricing for container products with AWS License Manager. To learn more about custom metering for usage-based pricing, see Configuring custom metering for container products with AWS Marketplace Metering Service.
-
Select Next.
-
In Set prices.
-
Select Next.
Step 3: Specify refund policy
-
Enter a refund policy.
-
Select Next.
Note
If you chose the free product pricing model, you do not have to enter a refund policy.
Step 4: Configure EULA
-
Choose Standard Contract for AWS Marketplace or Custom EULA.
Note
If you choose Custom EULA, enter a URL for the end-user license agreement.
-
Select Next.
Step 5: Add repositories
-
Add an initial repository for your container product.
Note
Repository names must be unique across all products in your seller account. You can create up to 50 repositories per product.
-
Select Next.
Step 6: Configure offer availability / Allow list
-
In Configure offer availability, choose your geographic availability settings.
-
Select Next.
-
In Configure allowlist, list any AWS accounts that should have access to the listing while in the limited state.
-
Select Submit to create a new change request for limited visibility testing.
Wait 10-15 minutes until your request status is in the Succeeded state.
Step 7: Upload Container images and artifacts to repository
Note
See Amazon Bedrock AgentCore Runtime for AWS Marketplace on how to integrate AgentCore with your Container Image.
-
Locate the URL for the ECR repository:
-
Open the Server products page in AWS Marketplace Management Portal.
-
Select your container product to view the details.
-
Select the Repositories tab to copy the URL of the repository.
-
-
Select View push commands to open a list of instructions, including commands you can use to push Docker container images and Helm charts to that repository. For general information about how to push container images and other artifacts to repositories, see Pushing an image in the Amazon Elastic Container Registry User Guide.
Note
You can use the following Amazon Elastic Container Registry (Amazon ECR) API operations when calling docker pull or docker push:
-
DescribeImages - Use this to review the metadata about the images in a repository.
-
GetAuthorizationToken - Use to authenticate before uploading artifacts to the repository, then use docker pull or docker push commands.
-
ListImages - Use to view a list of images you pushed.
-
-
Use the commands listed to push any needed artifacts from your local repository to the AWS Marketplace repository for your product.
Note
The tag that you provide in the push commands is used to differentiate the version of the artifact that you are uploading to the repository. Use a tag that makes sense for the version the artifacts are a part of.
-
Repeat for each container image or artifact you need in your version.
Note
Your version can include up to 50 container images or artifacts in each delivery option. Refer to the following procedure for more information about delivery options.
-
After you upload your artifacts, you're ready to create the version of your product.
Note
Your container images are scanned automatically to see if they meet the Container-based product requirements for AWS Marketplace. For more information, see Container product scans for security issues.
Step 8: Add New Product Version with Assets
-
Open the AI Agents and Tools products page in the AWS Marketplace Management Portal.
Note
Only container products with versions that support Amazon Bedrock AgentCore Runtime are visible in the AI Agents and Tools products page. Before adding the first version, you will only find your product within the Server products page in the AWS Marketplace Management Portal. Once you've created the version for Amazon Bedrock AgentCore Runtime, you will find your container product within the AI Agents and Tools products page.
-
Select your container product and click the Request changes dropdown menu, select Update versions, and select Add new version.
-
In Delivery options, enter:
-
Version title
-
Release notes
-
-
Select Add delivery option.
-
For Delivery method, select Container image and fill in:
-
Supported services: select the environment that buyers can launch the software in.
-
For Bedrock AgentCore service, select AI Agent, MCP Server, or A2A Server in the Type field.
-
Container image: Repository URL and version tag you specified previously.
-
Delivery option title and Deployment option description: Enter a title and description for this delivery option.
-
Usage instructions: Enter detailed information to help your buyers use your software after launching it.
-
Environment Variables: Specify the environment variables buyers must provide to configure the runtime behavior of the agent. These variables can be used to pass settings, credentials, or custom flags to the container at startup. For each variable, provide the name as expected by your container, a description, and an optional default value. For variables such as credentials or API keys that are unique, do not provide a default value. You can use the description to specify details about the variable as well as possible values. All of the provided variables with their default values will be pre-populated when buyers launch your product.
-
If you selected an AI agent or A2A Server tool type, confirm that your agent uses reasoning LLMs and demonstrates autonomous capabilities. These requirements help ensure that agents offered on AWS Marketplace meet a high quality bar. If your agent does not meet both requirements, choose a different tool type.
-
Select Add version.
Wait and refresh the page until the request status shows Succeeded.
Adding a new version automatically scans the container images for vulnerabilities.
Step 9: Review Product Listing and Publish to Public
-
Open the AI Agent and Tools products page in the AWS Marketplace Management Portal.
-
Select your container product in the list.
-
Select View on AWS Marketplace.
-
Review your product detail page for accuracy. Ensure the usage instructions sufficiently guide the buyer through the necessary steps to launch your product.
-
Submit an Update visibility request to public:
-
From the Server products page, on the Current server product tab, select the container-based product that you want to modify. From the Request changes dropdown, choose Update visibility.
-
Container deployment details
Container deployment packages your AI agent or tool as a containerized application that customers can run in their own AWS environments. This approach provides the following benefits:
-
Data remains within the customer's environment
-
Customizable deployment configurations
-
Supported integration with Bedrock AgentCore Runtime and customer's existing infrastructure
When listing a containerized agent, provide clear deployment instructions, resource requirements, and configuration options to ensure successful customer implementation.
Technical requirements for Bedrock AgentCore Runtime Containers
Note
See Amazon Bedrock AgentCore Runtime for AWS Marketplace for more details.
When creating container-based AI agent products for AWS Marketplace, follow these requirements:
- MCP Server Requirements
-
-
Transport: Stateless streamable-http only
-
Session Management: Platform automatically adds
Mcp-Session-Idheader for session isolation -
Host: Container must listen on
0.0.0.0 -
Port: Container must expose port
8000for MCP server communication -
Path:
/mcp- POST endpoint for receiving MCP RPC messages. InvokeAgentRuntime for MCP servers will pass through requests to this path. -
Protocol: The MCP server must support the MCP protocol including protocol messages 'tools/list' and 'tools/call' (supported by common framework such as FastMCP).
-
- Agent Requirements
-
-
/ping Endpoint: GET endpoint for health checks
-
/invocations Endpoint: POST endpoint for agent interactions
-
Docker Container: ARM64 containerized deployment package
-
Port: Container must expose port
8080for HTTP-based agent communication -
No hardcoded credentials
-
Free of Common Vulnerabilities and Exposures (CVEs)
-
- A2A Server Requirements
-
-
Port: A2A servers run on port 9000 (vs 8080 for HTTP, 8000 for MCP)
-
Host: Container must listen on
0.0.0.0 -
Path: A2A servers are mounted at
/(vs/invocationsfor HTTP,/mcpfor MCP) -
Agent Cards: A2A provides built-in agent discovery through Agent Cards at
/.well-known/agent-card.json -
Protocol: Uses JSON-RPC for agent-to-agent communication
-
Authentication: Supports both SigV4 and OAuth 2.0 authentication schemes
-
- Usage instructions
-
Ensure instructions thoroughly guides customers through launching and configuring the product. Refer to Creating AMI and container product usage instructions for AWS Marketplace.
Testing and validation
Prior to publishing your MCP-compatible agent or tool to public, thoroughly test your implementation:
-
Verify usage instructions provides necessary information to launch and configure the product.
-
Test authentication flows and error handling
-
Validate performance under various load conditions
-
Ensure compatibility with popular MCP clients
-
Document any client-specific configuration requirements
Best Practices and Recommendations
Documentation Requirements
When listing an Model Context Protocol-compatible agent or tool on AWS Marketplace, include comprehensive documentation:
-
Detailed capability descriptions and examples
-
Authentication and configuration instructions
-
Sample code for common integration scenarios
-
Troubleshooting guides and error reference
-
Performance considerations and best practices
Additional resources
For more information about implementing Model Context Protocol in your AI agent or tool, refer to these resources: