AWS Labs Step Functions MCP Server

raw JSON →

0.1.22 verified Mon Apr 27 auth: no python

An AWS Labs Model Context Protocol (MCP) server for AWS Step Functions. Version 0.1.22, updated monthly.

pip install awslabs-stepfunctions-tool-mcp-server

Common errors

error ModuleNotFoundError: No module named 'stepfunctions_mcp' ↓

cause Trying to import from the full PyPI name with hyphens.

fix

Install the package and use from stepfunctions_mcp.server import StepFunctionsMCPServer.

error botocore.exceptions.NoCredentialsError: Unable to locate credentials ↓

cause Missing AWS credentials in environment or AWS config.

fix

Set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_DEFAULT_REGION environment variables or configure AWS CLI.

Warnings

gotcha The import path is not the package name. Use `from stepfunctions_mcp.server import StepFunctionsMCPServer`. ↓

fix Import from stepfunctions_mcp.server, not awslabs-stepfunctions-tool-mcp-server.

deprecated Older versions used environment variable `STEP_FUNCTIONS_ENDPOINT`. Now it is `AWS_STEPFUNCTIONS_ENDPOINT`. ↓

fix Use `AWS_STEPFUNCTIONS_ENDPOINT` instead.

gotcha The server uses subprocess to call the AWS CLI on some operations. Ensure AWS CLI is installed and configured for full functionality. ↓

fix Install AWS CLI and run `aws configure`.

Imports

StepFunctionsMCPServer

wrong

from awslabs_stepfunctions_tool_mcp_server import StepFunctionsMCPServer

correct

from stepfunctions_mcp.server import StepFunctionsMCPServer

Actual package name is stepfunctions-mcp, not the full PyPI name.

Quickstart

Minimal runnable script to start the MCP server.

import os
from stepfunctions_mcp.server import StepFunctionsMCPServer

# Ensure AWS credentials are set
os.environ.get('AWS_ACCESS_KEY_ID', '')
os.environ.get('AWS_SECRET_ACCESS_KEY', '')
os.environ.get('AWS_DEFAULT_REGION', 'us-east-1')

# Instantiate and run
server = StepFunctionsMCPServer()
server.run()