An MCP server that exposes PraisonAI AI agents and tools for use with Claude Desktop, Cursor, VS Code, Windsurf, and other MCP clients. - 🤖 AI Agents as Tools - Run PraisonAI agents directly from MCP - 🔄 Workflow Orchestration - Multi-step agent workflows - 🛠️ 64 Built-in Tools - Complete coverage of all PraisonAI features - ⚡ Easy Setup - Works with uvx or pip install The core tools for runnin
Add this skill
npx mdskills install MervinPraison/praisonai-mcpComprehensive MCP server exposing 64 well-documented PraisonAI tools with excellent multi-client setup guides
1# PraisonAI MCP Server23<p align="center">4 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://static.pepy.tech/badge/praisonaiagents" alt="Downloads" /></a>5 <a href="https://pypi.org/project/praisonaiagents/"><img src="https://img.shields.io/pypi/v/praisonaiagents" alt="PyPI" /></a>6 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License" /></a>7 <a href="https://registry.modelcontextprotocol.io/servers/io.github.MervinPraison/praisonai"><img src="https://img.shields.io/badge/MCP-Registry-blue" alt="MCP Registry" /></a>8</p>910An MCP server that exposes [PraisonAI](https://github.com/MervinPraison/PraisonAI) AI agents and tools for use with Claude Desktop, Cursor, VS Code, Windsurf, and other MCP clients.1112## Features1314- 🤖 **AI Agents as Tools** - Run PraisonAI agents directly from MCP15- 🔄 **Workflow Orchestration** - Multi-step agent workflows16- 🛠️ **64 Built-in Tools** - Complete coverage of all PraisonAI features17- ⚡ **Easy Setup** - Works with `uvx` or `pip install`1819## Installation2021```bash22# Using uvx (Recommended)23uvx praisonai-mcp2425# Using pip26pip install praisonai-mcp27```2829---3031## Available Tools (64 Total)3233### 🤖 Agent Tools (Primary)3435The core tools for running AI agents:3637| Tool | Description |38|------|-------------|39| `run_agent` | Run a PraisonAI agent with a prompt |40| `run_research` | Deep research on any topic |41| `run_auto_agents` | Auto-generate and run agents for a task |42| `run_handoff` | Run task with agent handoff/delegation |43| `generate_agents_yaml` | Generate agents.yaml configuration |4445### 🔄 Workflow Tools4647Orchestrate multi-step agent workflows:4849| Tool | Description |50|------|-------------|51| `workflow_run` | Run a multi-step workflow |52| `workflow_create` | Create a new workflow |53| `workflow_from_yaml` | Create workflow from YAML |54| `export_to_n8n` | Export workflow to n8n format |5556---5758### 🌐 Search Tools (13 tools)5960Unified web search with automatic fallback across multiple providers:6162| Tool | Description |63|------|-------------|64| `search_web` | **Unified search** - Auto-fallback across providers |65| `get_search_providers` | List available providers and their status |66| **Tavily** | |67| `tavily_search` | AI-powered search (requires `TAVILY_API_KEY`) |68| `tavily_extract` | Extract content from URLs |69| **Exa** | |70| `exa_search` | Semantic search (requires `EXA_API_KEY`) |71| `exa_search_contents` | Search with full content retrieval |72| `exa_find_similar` | Find similar pages to a URL |73| **You.com** | |74| `ydc_search` | AI search with LLM-ready snippets (requires `YDC_API_KEY`) |75| `ydc_news` | Live news search |76| **Free Providers** | |77| `duckduckgo_search` | DuckDuckGo search (no API key) |78| `wikipedia_search` | Wikipedia search |79| `arxiv_search` | arXiv academic papers |80| `searxng_search` | Self-hosted SearxNG meta search |8182### 🕷️ Crawl & Scrape Tools8384Web crawling and content extraction:8586| Tool | Description |87|------|-------------|88| `crawl4ai_scrape` | Scrape webpage using Crawl4AI |89| `crawl4ai_extract` | Extract structured data with Crawl4AI |90| `scrape_page` | Scrape webpage and extract text |91| `extract_links` | Extract all links from a webpage |92| `web_crawl` | Crawl website and extract content |9394---9596### 📦 Supporting Tools9798#### 🧠 Memory & Knowledge99| Tool | Description |100|------|-------------|101| `memory_add` | Add to memory store |102| `memory_search` | Search memories |103| `memory_list` | List all memories |104| `memory_clear` | Clear memories |105| `auto_extract_memories` | Auto-extract memories from text |106| `knowledge_add` | Add to knowledge base |107| `knowledge_search` | Search knowledge base |108109#### 📋 Planning & Research110| Tool | Description |111|------|-------------|112| `plan_create` | Create a plan for a goal |113| `plan_execute` | Execute a plan step by step |114| `deep_research` | Deep research with iterations |115| `analyze_repository` | Analyze a repository |116| `fast_context_search` | Search codebase for context |117118#### 💻 Code & Execution119| Tool | Description |120|------|-------------|121| `run_python` | Execute Python code |122| `run_shell` | Execute shell commands |123| `git_commit` | Create git commits |124| `code_apply_diff` | Apply SEARCH/REPLACE diff |125| `code_search_replace` | Search and replace in file |126127#### 📁 File Operations128| Tool | Description |129|------|-------------|130| `read_file` | Read file contents |131| `write_file` | Write content to file |132| `list_directory` | List directory contents |133| `read_csv` | Read CSV file |134| `write_csv` | Write CSV file |135| `read_json_file` | Read JSON file |136| `write_json_file` | Write JSON file |137| `read_yaml_file` | Read YAML file |138| `write_yaml_file` | Write YAML file |139140#### 🧮 Utilities141| Tool | Description |142|------|-------------|143| `calculate` | Evaluate math expressions |144| `get_current_time` | Get current date/time |145| `solve_equation` | Solve math equations |146| `convert_units` | Convert between units |147| `calculate_statistics` | Calculate statistics |148149#### 📈 Finance150| Tool | Description |151|------|-------------|152| `get_stock_price` | Get current stock price |153| `get_stock_history` | Get historical stock data |154155#### 🖼️ Image & Query156| Tool | Description |157|------|-------------|158| `analyze_image` | Analyze image using vision |159| `rewrite_query` | Rewrite query for better results |160| `expand_prompt` | Expand short prompt to detailed |161162#### ✅ Task Management163| Tool | Description |164|------|-------------|165| `todo_add` | Add task to todo list |166| `todo_list` | List all tasks |167| `todo_complete` | Mark task as completed |168169#### 💾 Session & State170| Tool | Description |171|------|-------------|172| `session_save` | Save current session |173| `session_load` | Load a saved session |174| `session_list` | List all sessions |175176#### 📜 Rules & Guardrails177| Tool | Description |178|------|-------------|179| `rules_list` | List all defined rules |180| `rules_add` | Add a new rule |181| `rules_get` | Get a specific rule |182| `guardrail_validate` | Validate content against rules |183184#### 🖥️ System & Telemetry185| Tool | Description |186|------|-------------|187| `list_processes` | List running processes |188| `get_system_info` | Get system information |189| `track_metrics` | Track metrics event |190| `get_metrics` | Get tracked metrics |191| `select_model` | Select best model for task |192193#### 🔌 MCP & Hooks194| Tool | Description |195|------|-------------|196| `mcp_list_servers` | List MCP servers |197| `mcp_connect` | Connect to MCP server |198| `hooks_list` | List available hooks |199| `docs_search` | Search documentation |200201---202203## MCP Client Configurations204205### Claude Desktop206207**Config file:** `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)208209```json210{211 "mcpServers": {212 "praisonai": {213 "command": "uvx",214 "args": ["praisonai-mcp"],215 "env": {216 "OPENAI_API_KEY": "your-openai-api-key",217 "TAVILY_API_KEY": "your-tavily-api-key"218 }219 }220 }221}222```223224### VS Code (GitHub Copilot)225226**Config file:** `.vscode/mcp.json`227228```json229{230 "inputs": [231 {232 "type": "promptString",233 "id": "openai-key",234 "description": "OpenAI API Key",235 "password": true236 }237 ],238 "servers": {239 "praisonai": {240 "command": "uvx",241 "args": ["praisonai-mcp"],242 "env": {243 "OPENAI_API_KEY": "${input:openai-key}"244 }245 }246 }247}248```249250### Cursor251252**Config file:** `~/.cursor/mcp.json`253254```json255{256 "mcpServers": {257 "praisonai": {258 "command": "uvx",259 "args": ["praisonai-mcp"],260 "env": {261 "OPENAI_API_KEY": "your-openai-api-key"262 }263 }264 }265}266```267268### Windsurf269270**Config file:** `~/.codeium/windsurf/mcp_config.json`271272```json273{274 "mcpServers": {275 "praisonai": {276 "command": "uvx",277 "args": ["praisonai-mcp"],278 "env": {279 "OPENAI_API_KEY": "your-openai-api-key"280 }281 }282 }283}284```285286### Cline (VS Code Extension)287288Open Command Palette → "Cline: MCP Servers" → Add:289290```json291{292 "mcpServers": {293 "praisonai": {294 "command": "uvx",295 "args": ["praisonai-mcp"],296 "env": {297 "OPENAI_API_KEY": "your-openai-api-key"298 }299 }300 }301}302```303304### Continue305306**Config file:** `~/.continue/config.json`307308```json309{310 "experimental": {311 "modelContextProtocolServers": [312 {313 "transport": {314 "type": "stdio",315 "command": "uvx",316 "args": ["praisonai-mcp"]317 }318 }319 ]320 }321}322```323324### Zed325326**Config file:** `~/.config/zed/settings.json`327328```json329{330 "context_servers": {331 "praisonai": {332 "command": {333 "path": "uvx",334 "args": ["praisonai-mcp"]335 }336 }337 }338}339```340341### Claude Code (CLI)342343```bash344claude mcp add praisonai -- uvx praisonai-mcp345```346347---348349## Environment Variables350351| Variable | Description | Required For |352|----------|-------------|--------------|353| `OPENAI_API_KEY` | OpenAI API key | Agent tools |354| `TAVILY_API_KEY` | Tavily search API key | tavily_search, tavily_extract |355| `EXA_API_KEY` | Exa search API key | exa_search, exa_search_contents, exa_find_similar |356| `YDC_API_KEY` | You.com API key | ydc_search, ydc_news |357| `SEARXNG_URL` | SearxNG instance URL | searxng_search (optional) |358359---360361## Running as SSE Server362363```bash364python -m praisonai_mcp --sse --port 8080365```366367---368369## Links370371- 📖 [Documentation](https://docs.praison.ai/mcp)372- 🐙 [PraisonAI](https://github.com/MervinPraison/PraisonAI)373- 📦 [MCP Registry](https://registry.modelcontextprotocol.io/servers/io.github.MervinPraison/praisonai)374375## License376377MIT License378
Full transparency — inspect the skill content before installing.