# mcp_arena — condensed reference for LLMs Version 0.5.0 · Python 3.12+ · MIT · https://mcparena.vercel.app/docs ## What it is mcp_arena builds MCP (Model Context Protocol) servers. A preset is a `BaseMCPServer` subclass that registers tools with `@self.mcp_server.tool()` in `_register_tools()`. Every preset supports stdio, sse and streamable-http transports via `server.run()`. ## Install - `pip install mcp-arena` — core with three presets: local_operation, generic_api, smtp - `pip install "mcp-arena[]"` — one extra per preset or group - `pip install "mcp-arena[all]"` — every preset - `pip install "mcp-arena[agents]"` — LangChain bridge (langchain + langchain-mcp-adapters) ## All presets (module → class → extra) - slack → SlackMCPServer → slack - whatsapp → WhatsAppMCPServer → whatsapp - gmail → GmailMCPServer → gmail (alias of mail) - outlook → OutlookMCPServer → outlook - smtp → SMTPServer → core - mail → GmailMCPServer / MailMCPServer → mail - notification → NotificationMCPServer → notification - github → GithubMCPServer → github - gitlab → GitLabMCPServer → gitlab - bitbucket → BitbucketMCPServer → bitbucket - notion → NotionMCPServer → notion - confluence → ConfluenceMCPServer → bitbucket - jira → JiraMCPServer → bitbucket - postgres → PostgresMCPServer → postgres - mongo → MongoDBMCPServer → mongodb - redis → RedisMCPServer → redis - vectordb → VectorDBMCPServer → vectordb - context7 → Context7MCPServer → context7 - sentry → SentryMCPServer → sentry - aws → S3MCPServer → cloudstorage - cloudstorage → CloudStorageMCPServer → cloudstorage - docker → DockerMCPServer → docker - local_operation → LocalOperationsMCPServer → core - screencapture → ScreenCaptureMCPServer → screencapture - browser → BrowserMCPServer → browser - webscraping → WebScrapingMCPServer → webscraping - generic_api → GenericAPIMCPServer → core - image → ImageMCPServer → image - video → VideoMCPServer → video - audio → AudioMCPServer → audio - pdf → PDFMCPServer → pdf - qrcode → QRCodeMCPServer → qrcode - spreadsheet → SpreadsheetMCPServer → spreadsheet ## New in 0.5.0 - Context7MCPServer: resolve_library_id, query_docs, search_docs. CONTEXT7_API_KEY optional. - SentryMCPServer: list_projects, search_issues, get_issue, list_issue_events. SENTRY_AUTH_TOKEN + SENTRY_ORG required. ## Server example ```python from mcp_arena.presents.context7 import Context7MCPServer server = Context7MCPServer() print(server.get_registered_tools()) server.run() # stdio ``` ## Agent API (current) - `make_mcp_agent(llm, servers, *, system_prompt=None, names=None, server_names=None, extra_tools=None, **kwargs)` → compiled LangGraph runnable (async) - `make_mcp_agent_sync(...)` → sync wrapper - `ToolRegistry`: register_server, register, keep, drop, rename, from_source, names, list, to_openai, get_callables - `BaseTool`: subclass with `execute()` for non-MCP tools - `MCPAgentWrapper(server).get_tools()` → plain callables ## Removed in 0.4.0 (do not use) ReactAgent, ReflectionAgent, PlanningAgent, RouterAgent, AgentFactory, policies, memory, MCPLangChainWrapper, MCPLangChainIntegration, CalculatorTool, FileSystemTool, SearchTool, WebTool, DataAnalysisTool, *MCPTools wrappers. ## CLI - `mcp-arena list` / `mcp-arena list --detailed` - `mcp-arena info ` - `mcp-arena validate ` - `mcp-arena run --mcp-server [--verbose] [--extra-key value ...]` - `mcp-arena about` ## Client integrations - LangChain: `make_mcp_agent` (native, recommended) - AutoGen: `McpWorkbench` + `StdioServerParams`; pin `mcp<2`; project archived - Microsoft Agent Framework: successor to AutoGen, native MCP - LlamaIndex: `BasicMCPClient` + `McpToolSpec`; needs `mcp>=2` (separate env) - Claude Desktop / Cursor / Cline / Windsurf: `mcpServers` JSON pointing at `mcp-arena run --mcp-server ` - OpenAI Agents SDK: `agents.mcp` server objects - Raw MCP: `ClientSession` + `stdio_client` ## Links - Docs: https://mcparena.vercel.app/docs - Full prompt for Claude Code: https://mcparena.vercel.app/prompt.md - GitHub: https://github.com/SatyamSingh8306/mcp_arena - PyPI: https://pypi.org/project/mcp-arena/