Amazon Bedrock AgentCore Gateway
This document provides information for AWS Marketplace sellers who want to list API-based AI agent products or tools that can be integrated with Amazon Bedrock AgentCore Gateway.
Important
Amazon Bedrock AgentCore is currently in Preview and is subject to change.
Overview
Amazon Bedrock AgentCore Gateway helps developers build, deploy, discover, and connect to tools at scale. The service enables you to:
-
Convert APIs, Lambda functions, and existing services into Model Context Protocol (MCP)-compatible tools
-
Make tools available to agents through Gateway endpoints
-
Use comprehensive ingress and egress authentication in a fully managed service
AI agents use these tools to perform tasks such as:
-
Querying databases
-
Sending messages
-
Analyzing documents
For more information, see Amazon Bedrock AgentCore Developer Guide.
Integration with Bedrock AgentCore Gateway
To enable Amazon Bedrock AgentCore Gateway integration for your SaaS API-based AI agent products, provide an OpenAPI specification.
OpenAPI specification requirements
Your OpenAPI specification must:
-
Include
operationId
fields for all operations -
Be free of semantic errors
-
Include a valid secure (https) endpoint URL in the server attribute
The following table shows supported and unsupported OpenAPI features:
Category | Supported | Not Supported |
---|---|---|
Version | 3.0 and 3.1 | 2 |
Schema definitions | Basic data types (string, number, boolean, etc.) | oneOf specifications |
Required field validation | anyOf specifications | |
Nested objects | ||
Arrays with item specs | ||
Standard HTTP methods | ||
Media types | application/json | Custom media types |
application/xml | Binary media types | |
multipart/form-data | ||
x-www-form-urlencoded | ||
Parameters | Simple path parameters and basic query parameters such as string/number/boolean types | Complex path parameter serialization |
Complex query parameter arrays | ||
Header parameter serialization | ||
Cookie parameter serialization | ||
Request and response | JSON bodies | |
XML bodies | ||
Standard HTTP status codes | ||
Validation | Basic field validation | Regex pattern validation |
Min/max value validation | ||
Security | N/A | Security schemes at spec level |
Multiple security schemes | ||
OAuth 2.0 at spec level | ||
API Key at spec level | ||
HTTP Basic auth at spec level | ||
Server configuration | Basic URL | |
URL with placeholders |
Enabling Bedrock AgentCore Gateway on AWS Marketplace
Before you enable Gateway integration, test your OpenAPI specification with Amazon Bedrock AgentCore Gateway by completing these tasks:
To enable Gateway integration:
-
Sign in to the AWS Marketplace Management Portal
. -
Open the SaaS products
page. -
On the SaaS products tab, select the product to modify.
-
From the Request changes dropdown list, select Update fulfillment options.
-
Choose Enable tool for Amazon Bedrock AgentCore integration.
-
Upload your OpenAPI specification.
-
Choose Submit.
After you submit, the request status appears as Under review in the Requests tab. When processing completes, the status changes to Succeeded.