timebound-iam MCP server
Commit Oct 27, 2026Issues short-lived, service-scoped AWS credentials via STS to allow AI agents to access AWS resources securely.
Also known as builder-magic/timebound-iam
- Stars
- 11
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 27, 2026
- License
- Apache-2.0
What is timebound-iam MCP?
timebound-iam issues short-lived, service-scoped AWS credentials via STS to allow AI agents to access AWS resources securely.
Summary generated from the project's README
About timebound-iam MCP server
Providing temporary AWS access to AI agents is the primary function of timebound-iam. This MCP server acts as a broker between tools like Claude Code and AWS STS to issue short-lived credentials that are scoped to specific services and access levels. Instead of using long-lived keys, developers can grant agents permission to interact with resources like S3 or DynamoDB using credentials that expire automatically.
Users can install the server via Homebrew, Go, or direct binary downloads. After running a setup wizard to create a broker role in an AWS account, the server is registered with an AI client. The credentials issued are time-bounded, lasting anywhere from 15 minutes to 12 hours. The system supports specific access levels, including read-only or full permissions, and can also be used as a standalone CLI to wrap shell scripts or generate environment variables for manual use.
What you can do with it
- 1Granting temporary S3 accessRequest read-only credentials for S3 to allow an AI agent to inspect files without risking permanent access.
- 2Managing environment variables manuallyGenerate export statements to quickly set up a local terminal session with scoped AWS permissions.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablebuilder-magic/timebound-iam is public and reachablegithub.com/builder-magic/timebound-iam ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-27github.com/builder-magic/timebound-iam ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubTimebound-IAM is an MCP Server that issues short-lived, service-scoped AWS credentials via STS AssumeRole so that AI coding agents (like Claude Code) can access AWS resources without long-lived keys. Credentials are time-bounded (15 minutes to 12 hours), scoped to specific services and access levels (read-only or full), and automatically cleaned up on expiry.
Install
-
Homebrew (macOS/Linux)
brew install builder-magic/tap/timebound-iam -
Go install
go install github.com/builder-magic/timebound-iam@latest -
Binary download — Download pre-built binaries from GitHub Releases.
Setup
For the complete installation and setup guide, see https://timebound-iam.com/installation-and-setup.
-
Configure AWS
Run the setup wizard to generate the IAM trust policy and inline policy for the broker role:
bin/timebound-iam setup aws # or specify a named profile bin/timebound-iam setup aws --profile my-profileFollow the printed instructions to create the
timebound-iam-brokerIAM role in your account with the generated policies. -
Add to Claude Code
Register the MCP server so Claude Code can request temporary credentials on demand:
claude mcp add --scope user timebound-iam -- timebound-iam serveRestart Claude Code to pick up the new server.
-
Verify
Verify that the MCP server is installed and running with the
/mcpcommand:Test the credential flow end-to-end:
timebound-iam testThis requests short-lived S3 read-only credentials and writes them to a temporary
.envfile you can use to verify access.
CLI Usage
Timebound-IAM can also be used as a standalone CLI to wrap shell scripts with scoped, temporary credentials.
-
execRuns a command with temporary credentials injected into its environment:
timebound-iam exec -s s3:full,cloudfront:full -t 30m --profile prod -- ./deploy.shUse
--dry-runto validate flags without requesting credentials. Use--no-confirmto skip the interactive prompt in CI or scripts. -
envPrints
exportorunsetstatements for use witheval:eval "$(timebound-iam env -s s3:ro -t 15m --no-confirm)" aws s3 ls eval "$(timebound-iam env --unset)" -
Scopes
Scopes use the format
service:levelwhere level isro(read-only) orfull. Multiple scopes can be comma-separated or passed as repeated-sflags:-s s3:ro,dynamodb:full -s s3:ro -s dynamodb:full
Contributing
Contributions in any form (suggestions, bug reports, pull requests, and feedback) are welcome. If you've found a bug, you can submit an issue or email me at rsingh@builder-magic.com.
License
This project is licensed under the Apache License, Version 2.0.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed under the Apache License, Version 2.0, without any additional terms or conditions.
Contact: rsingh@builder-magic.com
timebound-iam MCP questions
How long do the issued credentials last?
Credentials are time-bounded, lasting anywhere from 15 minutes to 12 hours.
Can I use this outside of an AI agent?
Yes, it can be used as a standalone CLI to wrap shell scripts with scoped, temporary credentials.
How do I install it on macOS or Linux?
You can install it using Homebrew with the command brew install builder-magic/tap/timebound-iam.