← Explore all mcp servers

AWS DATA SERVICES / AWS Labs

AWS Labs Step Functions Tools

Exposes selected existing Step Functions state machines as executable MCP tools, with Standard polling and synchronous Express execution.

“A Model Context Protocol (MCP) server for AWS Step Functions to select and run state machines as MCP tools without code changes.”

01 / THE REASONING

Why this made the selection.

  • Specialized publisher integration with documented IAM and data access boundaries.
  • Invoke a reviewed workflow that already implements a constrained business operation.
  • The README turns existing Step Functions state machines into MCP tools without editing their definitions.
  • The model is limited to invoking those state machines. Other AWS calls stay inside the state machine's own role.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • src/stepfunctions-tool-mcp-server/README.md
  • src/stepfunctions-tool-mcp-server/pyproject.toml
  • src/stepfunctions-tool-mcp-server/awslabs/stepfunctions_tool_mcp_server/server.py
  • Root README.md and LICENSE
  • LICENSE

Our findings

  • Pinned implementation has an unbounded Standard completion polling loop and separate Express synchronous handling. Input schema references supplement documentation, not downstream authorization.
  • The server exposes Standard and Express state machines as tools and can validate inputs with EventBridge Schema Registry. Definitions do not have to be edited.
  • IAM on the MCP side is for invoking state machines. The README says models do not get direct access to other AWS services. Those calls use the state machine role. The default profile and region are default and us-east-1.
  • With no prefix and no list, every state machine passes the name check. A tag filter with only the key or only the value selects no state machine.

Not established by this review

  • Server startup, authentication, live tool execution and security isolation were not tested.
  • Published package/container parity with a source revision and hosted implementation internals were not tested.
  • The server was not started and its tools were not called.
  • A pin does not verify transitive dependencies.
  • No tools/list or tool call was made.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Connect a server deliberately.

Upstream setup instructions ↗

DOCUMENTED COMMAND

uvx awslabs.stepfunctions-tool-mcp-server@latest

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. Create and review the workflow separately, including execution-role permissions and failure/retry semantics.
  2. Set explicit state-machine selection and grant needed list/describe/start permissions for the intended region.
  3. Inspect the generated tool description/schema, then approve real execution; preserve the execution ARN for status reconciliation.

Before you start

  • Python 3.10 or newer, uv/uvx and an MCP client that can launch a local stdio process.
  • An AWS account, configured credentials and access to the intended region and service resources.

Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

{
  "mcpServers": {
    "awslabs-stepfunctions-tool": {
      "command": "uvx",
      "args": [
        "awslabs.stepfunctions-tool-mcp-server@latest"
      ],
      "env": {
        "AWS_PROFILE": "YOUR_RESTRICTED_PROFILE",
        "AWS_REGION": "us-east-1",
        "STATE_MACHINE_LIST": "YOUR_REVIEWED_STATE_MACHINE"
      }
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/stepfunctions-tool-mcp-server/README.md

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports, license

  2. https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/stepfunctions-tool-mcp-server/pyproject.toml

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports, license

  3. https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/src/stepfunctions-tool-mcp-server/awslabs/stepfunctions_tool_mcp_server/server.py

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports, license

  4. https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/README.md

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports, license

  5. Applicable licence ↗Checked

    https://github.com/awslabs/mcp/blob/8840003820a78dd018561d55c7ab12fcdd708464/LICENSE

    Supports: license

Evidence & Ask