Understand the AgentCore Runtime service contract
The AgentCore Runtime service contract defines the standardized communication protocol that your agent application must implement to integrate with the Amazon Bedrock agent hosting infrastructure. This contract ensures seamless communication between your custom agent code and AWS's managed hosting environment.
Topics
Supported protocols
The AgentCore Runtime service contract supports the following communication protocols:
Compare supported protocols
Compare the HTTP, MCP, A2A, and AG-UI protocols to understand the differences and use cases.
| Feature | HTTP Protocol | MCP Protocol | A2A Protocol | AG-UI Protocol |
|---|---|---|---|---|
|
Default serving port |
8080 |
8000 |
9000 |
8080 |
|
Default mount path |
/invocations (HTTP), /ws (WebSocket) |
/mcp |
/ (root) |
/invocations (SSE), /ws (WebSocket) |
|
Message Format |
REST JSON/SSE, WebSocket (text/binary) |
JSON-RPC |
JSON-RPC 2.0 |
Event streams (SSE/WebSocket) |
|
Discovery |
N/A |
Tool listing |
Agent Cards |
N/A |
|
Authentication |
SigV4, OAuth 2.0; WebSocket supports SigV4 by headers and query params |
SigV4, OAuth 2.0 |
SigV4, OAuth 2.0 |
SigV4, OAuth 2.0 |
|
Use Case |
Direct API calls, real-time streaming |
Tool servers |
Agent-to-agent communication |
Interactive UI experiences |
You can configure the serving port and the POST path used by InvokeAgentRuntime. For configuration details and examples, see Configure your agent’s serving port and invocation path.
To access application-defined HTTP methods and paths or additional servers in a session, enable session endpoints with allowedPorts. For more information, see Connect to runtime sessions through a session endpoint.
Lifecycle hooks
You can configure lifecycle hooks: endpoints in your container that AgentCore Runtime calls at specific points in your agent runtime’s lifecycle, such as while it prepares your agent. A hook endpoint uses the path and port that you choose, and it works the same way for every protocol. For more information, see Configure lifecycle hooks for AgentCore Runtime.
Reserved platform ports
AgentCore Runtime reserves the following ports for platform use:
-
1144 -
1514 -
1571 -
2049 -
4317–4318(inclusive) -
8443 -
48620 -
48640 -
53530–53532(inclusive)
Choose other ports for your application servers. An allowedPorts entry cannot specify a reserved port or a range that contains any reserved port. For the other port validation rules, see Configure allowed ports.