# aws/agent-toolkit-for-aws architecture

> Architecture diagram of the GitHub repository aws/agent-toolkit-for-aws, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aws/agent-toolkit-for-aws
- Repository: https://github.com/aws/agent-toolkit-for-aws

## Overview

Agent Toolkit for AWS equips coding agents with AWS-specific guidance, executable helpers, and MCP access. The principal workflow is a developer asking an agent to perform AWS work; the agent consults an applicable skill, uses MCP or a skill’s scripts to interact with AWS, and returns results. The repository also covers AI/ML model selection, fine-tuning, deployment, and evaluation, plus observability, startup planning, and agent payments. README documents broader plugin capabilities; those branches are represented at directory level where source was not sampled.

Main entry points: [`plugins`](https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins) (Toolkit plugins), [`plugins/aws-agents/skills/agents-pay/packages/openclaw/src/index.ts`](https://github.com/aws/agent-toolkit-for-aws/blob/main/plugins/aws-agents/skills/agents-pay/packages/openclaw/src/index.ts) (Agent payments), [`plugins/aws-agents/skills/agents-pay/packages/openclaw/src/payments.ts`](https://github.com/aws/agent-toolkit-for-aws/blob/main/plugins/aws-agents/skills/agents-pay/packages/openclaw/src/payments.ts) (Payment logic), [`plugins/aws-core/skills`](https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-core/skills) (Core skills)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Agent entry"]
  node_coding_agent["Coding agent"]
  node_toolkit["Toolkit plugins"]
end

subgraph group_guidance["Skills and guidance"]
  node_core_skills["Core skills"]
  node_agent_skills["Agent skills"]
  node_analytics_skills["Analytics skills"]
end

subgraph group_aws_workflows["AWS workflows"]
  node_model_select["Model selection"]
  node_finetuning["Model fine-tuning"]
  node_model_deploy["Model deployment"]
  node_model_eval["Model evaluation"]
  node_dataset_ops["Dataset operations"]
  node_observability["Observability"]
  node_startup_advisor["Startup and migration"]
  node_launch_aws["Launch with AWS"]
  node_graph_rag["GraphRAG pipeline"]
end

subgraph group_integrations["Runtime integrations"]
  node_payments["Agent payments<br/>[index.ts]"]
  node_payment_logic["Payment logic<br/>[payments.ts]"]
  node_x402["x402 protocol<br/>[x402.ts]"]
  node_aws_mcp{{"AWS MCP server"}}
  node_aws_services{{"AWS services"}}
  node_payment_service{{"Payment provider"}}
end

node_developer(("Developer"))

node_developer -->|"requests work"| node_coding_agent
node_coding_agent -->|"uses plugins"| node_toolkit
node_toolkit -->|"bundles skills"| node_core_skills
node_toolkit -->|"bundles skills"| node_agent_skills
node_coding_agent -->|"consults guidance"| node_core_skills
node_coding_agent -->|"consults guidance"| node_agent_skills
node_coding_agent -->|"consults guidance"| node_analytics_skills
node_coding_agent -->|"invokes AWS APIs"| node_aws_mcp
node_aws_mcp -->|"calls APIs"| node_aws_services
node_coding_agent -->|"runs skill"| node_model_select
node_coding_agent -->|"runs skill"| node_finetuning
node_coding_agent -->|"runs skill"| node_model_deploy
node_coding_agent -->|"runs skill"| node_model_eval
node_coding_agent -->|"runs skill"| node_dataset_ops
node_coding_agent -->|"runs skill"| node_observability
node_coding_agent -->|"uses guidance"| node_startup_advisor
node_coding_agent -->|"runs skill"| node_launch_aws
node_coding_agent -->|"runs helper"| node_graph_rag
node_coding_agent -->|"invokes tools"| node_payments
node_payments -->|"processes payment"| node_payment_logic
node_payments -->|"probes and replays"| node_x402
node_payment_logic -.->|"requests payment"| node_payment_service

click node_toolkit "https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins"
click node_core_skills "https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-core/skills"
click node_agent_skills "https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-agents/skills"
click node_analytics_skills "https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills"
click node_model_select "https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-ai-ml/references/model-selection/scripts"
click node_finetuning "https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-ai-ml/references/finetuning/code_templates"
click node_model_deploy "https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-ai-ml/references/model-deployment/code_templates"
click node_model_eval "https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-ai-ml/references/model-evaluation/code_templates"
click node_dataset_ops "https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-ai-ml/references/dataset-transformation"
click node_observability "https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-core/skills/aws-observability/scripts"
click node_startup_advisor "https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-startup-advisor/skills"
click node_launch_aws "https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/launch-with-aws/scripts"
click node_graph_rag "https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-neptune/scripts/graphrag_pipeline.py"
click node_payments "https://github.com/aws/agent-toolkit-for-aws/blob/main/plugins/aws-agents/skills/agents-pay/packages/openclaw/src/index.ts"
click node_payment_logic "https://github.com/aws/agent-toolkit-for-aws/blob/main/plugins/aws-agents/skills/agents-pay/packages/openclaw/src/payments.ts"
click node_x402 "https://github.com/aws/agent-toolkit-for-aws/blob/main/plugins/aws-agents/skills/agents-pay/packages/openclaw/src/x402.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_coding_agent,node_toolkit toneBlue
class node_core_skills,node_agent_skills,node_analytics_skills toneAmber
class node_model_select,node_finetuning,node_model_deploy,node_model_eval,node_dataset_ops,node_observability,node_startup_advisor,node_launch_aws,node_graph_rag toneMint
class node_payments,node_payment_logic,node_x402,node_aws_mcp,node_aws_services,node_payment_service toneRose
class node_developer toneIndigo
```

## Components

### Agent entry

- **Coding agent**
- [Toolkit plugins](https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins): `plugins`

### Skills and guidance

- [Core skills](https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-core/skills): `plugins/aws-core/skills`
- [Agent skills](https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-agents/skills): `plugins/aws-agents/skills`
- [Analytics skills](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills): `skills/specialized-skills/analytics-skills`

### AWS workflows

- [Model selection](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-ai-ml/references/model-selection/scripts): `skills/core-skills/aws-ai-ml/references/model-selection/scripts`
- [Model fine-tuning](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-ai-ml/references/finetuning/code_templates): `skills/core-skills/aws-ai-ml/references/finetuning/code_templates`
- [Model deployment](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-ai-ml/references/model-deployment/code_templates): `skills/core-skills/aws-ai-ml/references/model-deployment/code_templates`
- [Model evaluation](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-ai-ml/references/model-evaluation/code_templates): `skills/core-skills/aws-ai-ml/references/model-evaluation/code_templates`
- [Dataset operations](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/aws-ai-ml/references/dataset-transformation): `skills/core-skills/aws-ai-ml/references/dataset-transformation`
- [Observability](https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-core/skills/aws-observability/scripts): `plugins/aws-core/skills/aws-observability/scripts`
- [Startup and migration](https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-startup-advisor/skills): `plugins/aws-startup-advisor/skills`
- [Launch with AWS](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/core-skills/launch-with-aws/scripts): `skills/core-skills/launch-with-aws/scripts`
- [GraphRAG pipeline](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-neptune/scripts/graphrag_pipeline.py): `skills/specialized-skills/database-skills/amazon-neptune/scripts/graphrag_pipeline.py`

### Runtime integrations

- [Agent payments](https://github.com/aws/agent-toolkit-for-aws/blob/main/plugins/aws-agents/skills/agents-pay/packages/openclaw/src/index.ts): `plugins/aws-agents/skills/agents-pay/packages/openclaw/src/index.ts`
- [Payment logic](https://github.com/aws/agent-toolkit-for-aws/blob/main/plugins/aws-agents/skills/agents-pay/packages/openclaw/src/payments.ts): `plugins/aws-agents/skills/agents-pay/packages/openclaw/src/payments.ts`
- [x402 protocol](https://github.com/aws/agent-toolkit-for-aws/blob/main/plugins/aws-agents/skills/agents-pay/packages/openclaw/src/x402.ts): `plugins/aws-agents/skills/agents-pay/packages/openclaw/src/x402.ts`
- **AWS MCP server**
- **AWS services**
- **Payment provider**

### Other components

- **Developer**

## Connections

- Developer → Coding agent: requests work
- Coding agent → Toolkit plugins: uses plugins
- Toolkit plugins → Core skills: bundles skills
- Toolkit plugins → Agent skills: bundles skills
- Coding agent → Core skills: consults guidance
- Coding agent → Agent skills: consults guidance
- Coding agent → Analytics skills: consults guidance
- Coding agent → AWS MCP server: invokes AWS APIs
- AWS MCP server → AWS services: calls APIs
- Coding agent → Model selection: runs skill
- Coding agent → Model fine-tuning: runs skill
- Coding agent → Model deployment: runs skill
- Coding agent → Model evaluation: runs skill
- Coding agent → Dataset operations: runs skill
- Coding agent → Observability: runs skill
- Coding agent → Startup and migration: uses guidance
- Coding agent → Launch with AWS: runs skill
- Coding agent → GraphRAG pipeline: runs helper
- Coding agent → Agent payments: invokes tools
- Agent payments → Payment logic: processes payment
- Agent payments → x402 protocol: probes and replays
- Payment logic → Payment provider: requests payment