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": ["agent-builder-mcp-aws-transform"]
    }
  }
}

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:
Newer release available (1.1.1)

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.0.tar.gz (207.6 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.0-py3-none-any.whl (229.2 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for agent_builder_mcp_aws_transform-1.1.0.tar.gz
Algorithm Hash digest
SHA256 184a94fd602c228bbc0531521639f70fda3d8d71d52bd85b3bdf3db4ddf1ce6e
MD5 62551b48b16607bd9856e05abf3bf9b7
BLAKE2b-256 5b00d95a8305a1c1d48bd20652c97d87c4e26e7b867dd744a37f18166424e50b

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_builder_mcp_aws_transform-1.1.0.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.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_builder_mcp_aws_transform-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8ff10cecdcceb12069578a73a5eaab5c86aba4d84d79683777a45b7d50213ee0
MD5 e48eef7698e11aa67c2c9d0e04cc6ffa
BLAKE2b-256 77227c2aa4e8b1046091f88c6d169d3bc35dad7bd51e1773204935a40317ea29

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_builder_mcp_aws_transform-1.1.0-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