Skip to main content

​
Prerequisites

Python 3.10+

mcp-agent targets Python 3.10 or newer.

Node.js (optional)

Some MCP servers (e.g. filesystem) are distributed via npx and require Node.js.

​
Run the CLI with uvx

You can run mcp-agent commands without a global install by using uvx: 
uvx mcp-agent --version
The first run downloads the package into uv’s cache; subsequent runs are instant. Whenever you see a command such as uvx mcp-agent deploy …, you can paste it directly into your terminal. If you prefer a persistent install, pip install mcp-agent still works—but uvx keeps things simple.

​
Add mcp-agent to your project

Inside your project directory, initialize a new project and add mcp-agent as a dependency: 
uv init
uv add mcp-agent
Or with pip: 
pip install mcp-agent
uv add writes to pyproject.toml and uv.lock, which the project templates (uvx mcp-agent init …) expect.

​
Provider extras

mcp-agent includes optional extras for different LLM providers. Install the ones you need: 
uv add "mcp-agent[openai]"
pip install "mcp-agent[openai]"

uv add "mcp-agent[anthropic]"
uv add "mcp-agent[anthropic_bedrock]"
uv add "mcp-agent[anthropic_vertex]"
pip install "mcp-agent[anthropic]"

uv add "mcp-agent[azure]"
pip install "mcp-agent[azure]"

uv add "mcp-agent[bedrock]"
pip install "mcp-agent[bedrock]"

uv add "mcp-agent[google]"
pip install "mcp-agent[google]"

uv add "mcp-agent[openai,anthropic,azure,bedrock,google]"
pip install "mcp-agent[openai,anthropic,azure,bedrock,google]"

​
Verify your setup

1

Create a project folder

mkdir mcp-agent-playground
cd mcp-agent-playground
2

Install dependencies

uv init
uv add mcp-agent
3

Smoke test

uv run python -c "import mcp_agent; print('mcp-agent installed successfully!')"
Refer to the CLI reference for the complete command list, then head to the Quickstart to scaffold a project with uvx mcp-agent init.

​
Next steps

  • Quickstart – create a finder agent and run it locally.
  • Deploy to Cloud – publish your agent with uvx mcp-agent deploy.
  • MCP Servers – learn how FastMCP and other servers plug into your agents.
⌘I