mcp-agent
mcp-agent, from LastMile AI, is a Python framework built on the idea that MCP is all you need to build agents. It manages the lifecycle of MCP server connections for you, and an agent is declared with a name, an instruction and the MCP servers it may use, such as filesystem and fetch in the README's minimal example. You then attach an LLM (OpenAI in the example) and ask it to do the work.
The README lists three pillars. It implements every pattern from Anthropic's Building Effective Agents article in a composable way (map-reduce, orchestrator, evaluator-optimizer, router and more), so patterns can be chained. It claims full MCP support, including tools, resources, prompts, notifications, OAuth, sampling, elicitation and roots. And it can run the same agent code on Temporal for durable workflows that pause, resume and recover without API changes.
It can also expose agents as MCP servers with a FastMCP-compatible API, and offers a beta cloud deployment path (mcp-c). Install with `pip install mcp-agent`; the full docs, an llms.txt and a docs MCP server are at docs.mcp-agent.com. Our data shows the last push on 2026-01-25.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-01-25
- Commits, last 90 days
- 0
- Releases, last 90 days
- 0
- Latest release
- v0.0.21 (2025-05-09)
- Open issues
- 148
- Recent issues with at least one comment
- 2/10
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #40 Support LLMs through Cloud Vendors18 comments · 2025-03-05
- #25 content in OpenAI ChatCompletion messages is a list, not string16 comments · 2025-02-13
- #151 [mcp_agent.mcp.mcp_agent_client_session] send_request failed: EndOfStream() (EndOfStream)13 comments · 2025-04-23
- #11 Surfacing intermediate events (e.g. tool calls, LLM generations, etc.) in a long-running flow.9 comments · 2025-01-29
- #33 Use of agents in threads8 comments · 2025-02-28
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Compatibility
Quick start
Use cases
Alternatives
Comments
No comments yet. Be the first!