Agent Action Protocol (AAP) – MCP got us started, but is insufficient vs AWS MCP Servers

Defines a standardized schema for agent actions that extends beyond MCP's limitations by supporting stateful action chains, conditional branching, and multi-step workflows. Uses a declarative JSON/YAML schema format that agents can parse to understand action preconditions, postconditions, side effects, and rollback semantics. Validates action payloads against the schema before execution to prevent malformed requests from reaching tools.

Unique: Extends MCP's stateless request-response model with explicit preconditions, postconditions, and side-effect declarations in the action schema itself, enabling agents to reason about action safety and dependencies before execution rather than discovering constraints through failures

vs alternatives: More expressive than MCP for stateful workflows and safer than ad-hoc tool calling because agents can validate action feasibility before attempting execution

Orchestrates sequences of actions where later actions depend on state changes from earlier ones, tracking state mutations across the action chain. Implements a state machine pattern where each action declares what state it reads and writes, allowing the orchestrator to detect conflicts, serialize access, and enable rollback. Supports conditional branching based on action results without requiring the agent to re-plan between steps.

Unique: Implements explicit state tracking and conflict detection at the orchestration layer rather than delegating to individual tools, enabling deterministic rollback and preventing state corruption from concurrent or failed actions

vs alternatives: More robust than sequential tool calling (which has no rollback) and simpler than distributed transaction frameworks because state mutations are declared in the action schema

Manages multiple versions of actions simultaneously, enabling agents to use different versions based on their requirements or capabilities. Implements a versioning scheme where actions declare their version and breaking changes, and the orchestrator routes requests to compatible versions. Supports gradual migration from old to new action versions without breaking existing agents.

Unique: Treats action versioning as a first-class concern with explicit version routing rather than assuming all agents use the latest version, enabling safe evolution of action schemas

vs alternatives: More flexible than breaking changes because agents can continue using old versions while new agents adopt new versions

Instruments action execution with distributed tracing to track request flow across multiple actions and agents, capturing latency, dependencies, and error paths. Implements OpenTelemetry-compatible tracing where each action execution generates spans with metadata (inputs, outputs, duration, status), enabling visualization of action chains and performance analysis. Correlates traces across agents to understand multi-agent workflows.

Unique: Integrates distributed tracing at the orchestration layer to capture action execution flow across agents, enabling end-to-end visibility into multi-agent workflows

vs alternatives: More comprehensive than application-level logging because traces capture causal relationships between actions and enable visualization of action chains

Provides a testing framework for validating action behavior in isolation and in composition, supporting unit tests, integration tests, and simulation of action sequences. Implements mock actions for testing without external dependencies, and a simulation engine that replays action sequences to verify correctness. Supports property-based testing to verify action invariants.

Unique: Provides a dedicated testing framework for action compositions rather than requiring ad-hoc test code, enabling systematic validation of action behavior and error handling

vs alternatives: More comprehensive than unit testing individual actions because it tests action compositions and error recovery paths

Streams action results back to the agent and client in real-time rather than waiting for full completion, enabling progressive feedback loops where agents can react to partial results. Implements a streaming protocol that emits intermediate state changes, progress indicators, and error signals as they occur, allowing agents to make early decisions (e.g., cancel a long-running action if intermediate results are unsatisfactory).

Unique: Decouples action completion from result delivery by streaming intermediate state changes, allowing agents to make decisions during action execution rather than only after completion

vs alternatives: More responsive than polling-based progress checks and more flexible than fire-and-forget execution because agents can react to intermediate signals

Enables agents to discover available actions and their capabilities at runtime through a capability registry, negotiating which actions are available based on agent permissions, resource constraints, and runtime conditions. Implements a service discovery pattern where actions advertise their requirements (e.g., API keys, resource limits, dependencies) and the registry matches agent capabilities to available actions. Supports dynamic capability updates when new tools are registered or permissions change.

Unique: Treats action discovery as a first-class concern with explicit capability negotiation rather than assuming all agents have access to all tools, enabling fine-grained permission models and dynamic tool registration

vs alternatives: More flexible than static action lists and more secure than MCP's open-ended tool exposure because agents only see actions they're authorized to use

Defines declarative error handling strategies in action schemas, specifying how agents should respond to different failure modes (retry with backoff, fallback to alternative action, escalate to human, etc.). Implements a recovery pattern where actions declare their failure modes and the orchestrator automatically applies the appropriate recovery strategy without requiring agent-level error handling logic.

Unique: Moves error handling from agent logic to the orchestration layer by declaring recovery strategies in action schemas, enabling consistent, declarative error responses across all agents

vs alternatives: More maintainable than agent-level try-catch blocks because recovery strategies are centralized and reusable across agents

awslabs/mcp | DeepWiki Loading... Index your code with Devin DeepWiki DeepWiki awslabs/mcp Index your code with Devin Edit Wiki Share Loading... Last indexed: 8 January 2026 ( 49d158 ) Overview What is Model Context Protocol? Available MCP Servers Server Workflow Classifications Architecture System Design Client-Server Interaction Package Structure & Dependencies Security & Permission Model Documentation System Core Infrastructure Core MCP Server AWS API MCP Server Lambda Handler & Remote Servers Infrastructure as Code Servers AWS IaC MCP Server Terraform MCP Server CDK MCP Server CloudFormation & Cloud Control Servers Container & Compute Servers ECS MCP Server EKS & Kubernetes Servers Lambda Tool MCP Server Serverless & Container Tools AI & Machine Learning Servers Bedrock KB Retrieval MCP Server Nova Canvas MCP Server SageMaker AI MCP Server AWS HealthOmics MCP Server Bedrock AgentCore & Other AI Servers Data & Analytics Servers DynamoDB MCP Server PostgreSQL MCP Server Other Database Servers S3 Tables & Storage Servers Analytics & Data Processing Servers Operations & Monitoring Servers Cost Analysis & Explorer Servers AWS Diagram MCP Server CloudWatch & Monitoring Servers IAM & Security Servers Support & CloudTrail Servers Messaging & Integration Servers SNS/SQS & Messaging Servers Step Functions & Workflow Servers Developer Tools & Documentation AWS Docume

What is Model Context Protocol? | awslabs/mcp | DeepWiki Loading... Index your code with Devin DeepWiki DeepWiki awslabs/mcp Index your code with Devin Edit Wiki Share Loading... Last indexed: 8 January 2026 ( 49d158 ) Overview What is Model Context Protocol? Available MCP Servers Server Workflow Classifications Architecture System Design Client-Server Interaction Package Structure & Dependencies Security & Permission Model Documentation System Core Infrastructure Core MCP Server AWS API MCP Server Lambda Handler & Remote Servers Infrastructure as Code Servers AWS IaC MCP Server Terraform MCP Server CDK MCP Server CloudFormation & Cloud Control Servers Container & Compute Servers ECS MCP Server EKS & Kubernetes Servers Lambda Tool MCP Server Serverless & Container Tools AI & Machine Learning Servers Bedrock KB Retrieval MCP Server Nova Canvas MCP Server SageMaker AI MCP Server AWS HealthOmics MCP Server Bedrock AgentCore & Other AI Servers Data & Analytics Servers DynamoDB MCP Server PostgreSQL MCP Server Other Database Servers S3 Tables & Storage Servers Analytics & Data Processing Servers Operations & Monitoring Servers Cost Analysis & Explorer Servers AWS Diagram MCP Server CloudWatch & Monitoring Servers IAM & Security Servers Support & CloudTrail Servers Messaging & Integration Servers SNS/SQS & Messaging Servers Step Functions & Workflow Servers Developer

Architecture | awslabs/mcp | DeepWiki Loading... Index your code with Devin DeepWiki DeepWiki awslabs/mcp Index your code with Devin Edit Wiki Share Loading... Last indexed: 8 January 2026 ( 49d158 ) Overview What is Model Context Protocol? Available MCP Servers Server Workflow Classifications Architecture System Design Client-Server Interaction Package Structure & Dependencies Security & Permission Model Documentation System Core Infrastructure Core MCP Server AWS API MCP Server Lambda Handler & Remote Servers Infrastructure as Code Servers AWS IaC MCP Server Terraform MCP Server CDK MCP Server CloudFormation & Cloud Control Servers Container & Compute Servers ECS MCP Server EKS & Kubernetes Servers Lambda Tool MCP Server Serverless & Container Tools AI & Machine Learning Servers Bedrock KB Retrieval MCP Server Nova Canvas MCP Server SageMaker AI MCP Server AWS HealthOmics MCP Server Bedrock AgentCore & Other AI Servers Data & Analytics Servers DynamoDB MCP Server PostgreSQL MCP Server Other Database Servers S3 Tables & Storage Servers Analytics & Data Processing Servers Operations & Monitoring Servers Cost Analysis & Explorer Servers AWS Diagram MCP Server CloudWatch & Monitoring Servers IAM & Security Servers Support & CloudTrail Servers Messaging & Integration Servers SNS/SQS & Messaging Servers Step Functions & Workflow Servers Developer Tools & Documentati

awslabs/mcp | DeepWiki Loading... Index your code with Devin DeepWiki DeepWiki awslabs/mcp Index your code with Devin Edit Wiki Share Loading... Last indexed: 8 January 2026 ( 49d158 ) Overview What is Model Context Protocol? Available MCP Servers Server Workflow Classifications Architecture System Design Client-Server Interaction Package Structure & Dependencies Security & Permission Model Documentation System Core Infrastructure Core MCP Server AWS API MCP Server Lambda Handler & Remote Servers Infrastructure as Code Servers AWS IaC MCP Server Terraform MCP Server CDK MCP Server CloudFormation & Cloud Control Servers Container & Compute Servers ECS MCP Server EKS & Kubernetes Servers Lambda Tool MCP Server Serverless & Container Tools AI & Machine Learning Servers Bedrock KB Retrieval MCP Server Nova Canvas MCP Server SageMaker AI MCP Server AWS HealthOmics MCP Server Bedrock AgentCore & Other AI Servers Data & Analytics Servers DynamoDB MCP Server PostgreSQL MCP Server Other Database Servers S3 Tables & Storage Servers Analytics & Data Processing Servers Operations & Monitoring Serv