Metadata-Version: 2.4
Name: agent-builder-mcp-aws-transform
Version: 1.0.1
Summary: MCP server for building, deploying, and managing agents on AWS Transform
Author: AWS Transform Team
License-Expression: Apache-2.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE.txt
License-File: NOTICE
License-File: THIRD-PARTY-NOTICES.txt
Requires-Dist: mcp>=1.0
Requires-Dist: anyio>=4.0
Requires-Dist: rank-bm25>=0.2
Requires-Dist: snowballstemmer>=2.0
Requires-Dist: boto3>=1.28
Requires-Dist: requests>=2.28
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: hypothesis; extra == "test"
Dynamic: license-file

# Agent Builder MCP Server

An [MCP](https://modelcontextprotocol.io/) server that provides tools and knowledge for building, deploying, and managing agents on [AWS Transform](https://aws.amazon.com/transform/).

This server works with any MCP-compatible client — [Kiro](https://kiro.dev/), Claude Code, Cursor, Windsurf, or any other IDE/tool that supports the Model Context Protocol.

## Installation

```bash
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**](https://kiro.dev/powers/#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:

```json
{
  "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, 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.

## License

Apache-2.0. See [LICENSE](LICENSE.txt) and [THIRD-PARTY-NOTICES.txt](THIRD-PARTY-NOTICES.txt).
