Installation

Install asyncmcp and get up and running with your first server and client

This guide includes optional LocalStack setup for local AWS simulation.

asyncmcp can be installed using various Python package managers:

uv (Recommended)

# Add to current project
uv add asyncmcp

# Install globally
uv tool install asyncmcp

pip

# Basic installation
pip install asyncmcp

# Install from source
pip install git+https://github.com/bh-rat/asyncmcp.git

poetry

# Add to project
poetry add asyncmcp

pipenv

# Add to Pipfile
pipenv install asyncmcp

asyncmcp requires Python 3.10 or higher.

Optional: LocalStack Setup

If you want to test AWS transports locally without using real AWS resources:

1. Install LocalStack

   uv add localstack
   
2. Start LocalStack

   localstack start
   

   LocalStack will run on http://localhost:4566

Next Steps

Now that asyncmcp is installed, explore the specific transport guide for your use case:

SQS Transport

Simple queue-based async communication

SNS+SQS Transport

Topic-based pub/sub messaging

Webhook Transport

HTTP POST-based async messaging

StreamableHTTP+Webhook

Combined SSE and webhook approach

Need Help? Check out our GitHub repository for more examples and to report issues.