Metadata-Version: 2.4
Name: agent-builder-agentic-mcp-aws-transform
Version: 1.0.0
Summary: MCP server that agents built with the Agent Builder SDK use at runtime to talk to 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: boto3>=1.28
Requires-Dist: botocore>=1.28
Requires-Dist: requests>=2.28
Requires-Dist: structlog>=25.0
Requires-Dist: pydantic>=2.0
Requires-Dist: python-dotenv>=1.0
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-asyncio; extra == "test"
Requires-Dist: trio; extra == "test"
Dynamic: license-file

# Agent Builder Agentic MCP Server

An [MCP](https://modelcontextprotocol.io/) server that agents built with the [Agent Builder SDK](https://pypi.org/project/agent-builder-sdk-aws-transform/) use at runtime to talk to the [AWS Transform](https://aws.amazon.com/transform/) platform.

## Installation

```bash
pip install agent-builder-agentic-mcp-aws-transform
```

This installs an `agent-builder-agentic-mcp` command.

## Usage

### From the SDK (typical)

The SDK's `AgentRuntimeServer` spawns this MCP server automatically:

```python
from agent_builder_sdk.server.agent_runtime_server import AgentRuntimeServer

server = AgentRuntimeServer(
    agent_factory=my_factory,
    binary_location="agent-builder-agentic-mcp",  # the command installed by this package
    ...
)
server.start()
```

### Standalone (local testing)

```bash
agent-builder-agentic-mcp \
  --agenticApiEndpoint https://... \
  --workspaceId <workspace-id> \
  --jobId <job-id> \
  --agentInstanceId <agent-instance-id>
```

Run `agent-builder-agentic-mcp --help` for the full set of flags (transport, SSE host/port, custom auth token file, auto-refresh, etc.).

## Requirements

- Python 3.11+
- AWS credentials configured (standard `boto3` credential chain)
- A valid AWS Transform authorization token in `~/.aws/transform-credentials` (or specify with `--authTokenFile`)

## License

Apache-2.0. See [LICENSE](LICENSE.txt) and [NOTICE](NOTICE).
