Quickstart

Let’s get you set up with a hello world mcp-agent!

Create the agent

Use CLI (Recommended)
Do it manually

mkdir mcp-basic-agent
cd mcp-basic-agent
uvx mcp-agent init
uv init
uv add mcp-agent
uv sync

(Prefer pip? pip install mcp-agent works too.)

Run it locally

uv run main.py

You should see log entries for tool discovery, file access, web fetches, and the final summary tweet. Try editing the instructions or adding new MCP servers to see how the agent evolves.

Deploy it (optional)

You can deploy your agent as an MCP server.

uvx mcp-agent login
uvx mcp-agent deploy

Next steps

Check out the generated README (if you used the CLI) for tips on extending the agent.
Layer in more capabilities using the Effective Patterns guide.
Ready to deploy your agent? Follow Deploy to Cloud.

Get Started

MCP Agent SDK

Deployment

Test and Evaluate

Reference

Create the agent

Run it locally

Deploy it (optional)

Next steps

Get Started

MCP Agent SDK

Deployment

Test and Evaluate

Reference

​Create the agent

​Run it locally

​Deploy it (optional)

​Next steps

Create the agent

Run it locally

Deploy it (optional)

Next steps