mcp-agent

Overview

mcp-agent is a powerful Python framework that fully implements the Model Context Protocol (MCP) to build robust agents. It provides simple, composable patterns for agent development, supports both basic and sophisticated workflows with Temporal for durable execution, and allows agents to leverage MCP servers for various capabilities. The framework includes LLM integration, tools/resources/prompts support, and cloud deployment options, making it suitable for production-grade agent applications.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• fetch

  Fetch content from URLs using the fetch MCP server

  Try:Fetch content from https://example.comTry:Retrieve the webpage at https://www.anthropic.com/research/building-effective-agents
• filesystem

  Read and write files on the local filesystem using the filesystem MCP server

  Try:Show me what's in README.md verbatimTry:List all files in the current directory
• list_tools

  List all MCP tools available to the agent

  Try:What tools are available?Try:List all available functions

Note: Tool names were inferred from the example code showing the agent connecting to 'fetch' and 'filesystem' MCP servers, and the code demonstrating listing available tools.

Comparable tools

Installation

pip install mcp-agent

uv add mcp-agent

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

{
  "mcpServers": {
    "mcp-agent": {
      "command": "uvx",
      "args": ["mcp-agent", "run"]
    }
  }
}

FAQ

What MCP features are supported?

Full MCP support including tools, resources, prompts, notifications, OAuth, sampling, elicitation, and roots.

Can I use this with different LLM providers?

Yes, it supports OpenAI, Anthropic, Google, Azure, and Bedrock LLM providers with easy configuration.

On Hacker News

Recent discussion from the developer community.

• Show HN: Mcp-Agent – Build effective agents with Model Context Protocol▲ 80💬 28
  Story by saqadri · 2025-01-29
• Show HN: Representing Agents as MCP Servers▲ 58💬 16
  Story by saqadri · 2025-05-21
• Show HN: I built an AI agent that helps me invest▲ 32💬 23
  Story by haniehz · 2025-07-19

Compare mcp-agent with