Agent Builder MCP Server

An MCP server that provides tools and knowledge for building, deploying, and managing agents on AWS Transform.

This server works with any MCP-compatible client — Kiro, Claude Code, Cursor, Windsurf, or any other IDE/tool that supports the Model Context Protocol.

Installation

pip install agent-builder-mcp-aws-transform

This installs an agent-builder-mcp command that speaks MCP over stdio.

Quick start

With Kiro (recommended)

Install the AWS Transform Agent Toolkit Kiro Power for the full guided experience — it configures this MCP server automatically and adds steering rules that guide Kiro through the entire agent-building process.

With any MCP client

Add the server to your MCP configuration:

{
  "mcpServers": {
    "agent-builder": {
      "command": "uvx",
      "args": ["--from", "agent-builder-mcp-aws-transform", "--with", "mcp>=1.0.0,<2.0.0", "agent-builder-mcp"]
    }
  }
}

Restart your IDE/tool. It will now have access to the agent-builder tool set.

What it provides

Tools are grouped into six categories:

  • Search — retrieve documentation and examples from the bundled AWS Transform knowledge base (BM25 keyword search, no network calls, no embeddings).
  • Agent registry — look up, register, update, deregister, and version agents.
  • Skill operations — manage the skills an agent exposes.
  • Deployment — package and deploy agents to AWS.
  • Validation — check agent manifests and configurations before deployment.
  • CloudWatch — query agent logs and metrics.

Requirements

  • Python 3.11+
  • AWS credentials configured (standard boto3 credential chain) for deployment and CloudWatch tools. Search and validation work offline.
  • Deployment & registration tools: Your AWS account must be allowlisted for the AWS Transform composability initiative. Contact your Partner Development Manager (PDM) or apply through AWS Partner Central. Search and validation tools work without allowlisting.

Development

Retrieval benchmark

The bundled BM25 search is gated by a quality benchmark (48 golden queries across 6 categories):

pip install -e .
python bench/eval_retrieval.py

CI enforces Recall@5 >= 0.70 and MRR >= 0.60. Current: Recall@5 = 0.80, MRR = 0.85.

License

Apache-2.0. See LICENSE and THIRD-PARTY-NOTICES.txt.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for aws-transform from gravatar.com aws-transform Avatar for osa-amazon from gravatar.com osa-amazon

Credits

Author: AWS Transform Team

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.11

Provides Extra

test

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent_builder_mcp_aws_transform-1.1.1.tar.gz (211.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agent_builder_mcp_aws_transform-1.1.1-py3-none-any.whl (232.4 kB view details)

Uploaded Python 3

File details

Details for the file agent_builder_mcp_aws_transform-1.1.1.tar.gz.

File metadata

File hashes

Hashes for agent_builder_mcp_aws_transform-1.1.1.tar.gz
Algorithm Hash digest
SHA256 9586b7e1e62101488cda09c95e99b46d3970a324542ce0613e24173d9cbc1e5d
MD5 96879a65f4a87b85e55a167eb309e2e1
BLAKE2b-256 f297b4048fe1729d30b69ebc6c32454fe1b5ad90f910cc3fa6b0c8f25441721f

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_builder_mcp_aws_transform-1.1.1.tar.gz:

Publisher: publish.yml on awslabs/agent-builder-toolkit-aws-transform

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agent_builder_mcp_aws_transform-1.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_builder_mcp_aws_transform-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 71a9b53059e01760b76574d78889ec60473471ff5f20ae3dd47e7d703cab3128
MD5 fc49b86d51430de725c8140b62a4b827
BLAKE2b-256 551491ce9cd94bb60a0b220947169f653384573ea5a0c935d4bac0e3c194c8e0

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_builder_mcp_aws_transform-1.1.1-py3-none-any.whl:

Publisher: publish.yml on awslabs/agent-builder-toolkit-aws-transform

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page