Praisonai Mcp

PraisonAI MCP Server

An MCP server that exposes PraisonAI AI agents and tools for use with Claude Desktop, Cursor, VS Code, Windsurf, and other MCP clients.

Features

• 🤖 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

Installation

# Using uvx (Recommended)
uvx praisonai-mcp

# Using pip
pip install praisonai-mcp

---

Available Tools (64 Total)

🤖 Agent Tools (Primary)

The core tools for running AI agents:

| Tool | Description | |------|-------------| | run_agent | Run a PraisonAI agent with a prompt | | run_research | Deep research on any topic | | run_auto_agents | Auto-generate and run agents for a task | | run_handoff | Run task with agent handoff/delegation | | generate_agents_yaml | Generate agents.yaml configuration |

🔄 Workflow Tools

Orchestrate multi-step agent workflows:

| Tool | Description | |------|-------------| | workflow_run | Run a multi-step workflow | | workflow_create | Create a new workflow | | workflow_from_yaml | Create workflow from YAML | | export_to_n8n | Export workflow to n8n format |

---

🌐 Search Tools (13 tools)

Unified web search with automatic fallback across multiple providers:

| Tool | Description | |------|-------------| | search_web | Unified search - Auto-fallback across providers | | get_search_providers | List available providers and their status | | Tavily | | | tavily_search | AI-powered search (requires TAVILY_API_KEY) | | tavily_extract | Extract content from URLs | | Exa | | | exa_search | Semantic search (requires EXA_API_KEY) | | exa_search_contents | Search with full content retrieval | | exa_find_similar | Find similar pages to a URL | | You.com | | | ydc_search | AI search with LLM-ready snippets (requires YDC_API_KEY) | | ydc_news | Live news search | | Free Providers | | | duckduckgo_search | DuckDuckGo search (no API key) | | wikipedia_search | Wikipedia search | | arxiv_search | arXiv academic papers | | searxng_search | Self-hosted SearxNG meta search |

🕷️ Crawl & Scrape Tools

Web crawling and content extraction:

| Tool | Description | |------|-------------| | crawl4ai_scrape | Scrape webpage using Crawl4AI | | crawl4ai_extract | Extract structured data with Crawl4AI | | scrape_page | Scrape webpage and extract text | | extract_links | Extract all links from a webpage | | web_crawl | Crawl website and extract content |

---

📦 Supporting Tools

🧠 Memory & Knowledge

| Tool | Description | |------|-------------| | memory_add | Add to memory store | | memory_search | Search memories | | memory_list | List all memories | | memory_clear | Clear memories | | auto_extract_memories | Auto-extract memories from text | | knowledge_add | Add to knowledge base | | knowledge_search | Search knowledge base |

📋 Planning & Research

| Tool | Description | |------|-------------| | plan_create | Create a plan for a goal | | plan_execute | Execute a plan step by step | | deep_research | Deep research with iterations | | analyze_repository | Analyze a repository | | fast_context_search | Search codebase for context |

💻 Code & Execution

| Tool | Description | |------|-------------| | run_python | Execute Python code | | run_shell | Execute shell commands | | git_commit | Create git commits | | code_apply_diff | Apply SEARCH/REPLACE diff | | code_search_replace | Search and replace in file |

📁 File Operations

| Tool | Description | |------|-------------| | read_file | Read file contents | | write_file | Write content to file | | list_directory | List directory contents | | read_csv | Read CSV file | | write_csv | Write CSV file | | read_json_file | Read JSON file | | write_json_file | Write JSON file | | read_yaml_file | Read YAML file | | write_yaml_file | Write YAML file |

🧮 Utilities

| Tool | Description | |------|-------------| | calculate | Evaluate math expressions | | get_current_time | Get current date/time | | solve_equation | Solve math equations | | convert_units | Convert between units | | calculate_statistics | Calculate statistics |

📈 Finance

| Tool | Description | |------|-------------| | get_stock_price | Get current stock price | | get_stock_history | Get historical stock data |

🖼️ Image & Query

| Tool | Description | |------|-------------| | analyze_image | Analyze image using vision | | rewrite_query | Rewrite query for better results | | expand_prompt | Expand short prompt to detailed |

✅ Task Management

| Tool | Description | |------|-------------| | todo_add | Add task to todo list | | todo_list | List all tasks | | todo_complete | Mark task as completed |

💾 Session & State

| Tool | Description | |------|-------------| | session_save | Save current session | | session_load | Load a saved session | | session_list | List all sessions |

📜 Rules & Guardrails

| Tool | Description | |------|-------------| | rules_list | List all defined rules | | rules_add | Add a new rule | | rules_get | Get a specific rule | | guardrail_validate | Validate content against rules |

🖥️ System & Telemetry

| Tool | Description | |------|-------------| | list_processes | List running processes | | get_system_info | Get system information | | track_metrics | Track metrics event | | get_metrics | Get tracked metrics | | select_model | Select best model for task |

🔌 MCP & Hooks

| Tool | Description | |------|-------------| | mcp_list_servers | List MCP servers | | mcp_connect | Connect to MCP server | | hooks_list | List available hooks | | docs_search | Search documentation |

---

MCP Client Configurations

Claude Desktop

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "praisonai": {
      "command": "uvx",
      "args": ["praisonai-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "TAVILY_API_KEY": "your-tavily-api-key"
      }
    }
  }
}

VS Code (GitHub Copilot)

Config file: .vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "openai-key",
      "description": "OpenAI API Key",
      "password": true
    }
  ],
  "servers": {
    "praisonai": {
      "command": "uvx",
      "args": ["praisonai-mcp"],
      "env": {
        "OPENAI_API_KEY": "${input:openai-key}"
      }
    }
  }
}

Cursor

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "praisonai": {
      "command": "uvx",
      "args": ["praisonai-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key"
      }
    }
  }
}

Windsurf

Config file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "praisonai": {
      "command": "uvx",
      "args": ["praisonai-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key"
      }
    }
  }
}

Cline (VS Code Extension)

Open Command Palette → "Cline: MCP Servers" → Add:

{
  "mcpServers": {
    "praisonai": {
      "command": "uvx",
      "args": ["praisonai-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key"
      }
    }
  }
}

Continue

Config file: ~/.continue/config.json

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "uvx",
          "args": ["praisonai-mcp"]
        }
      }
    ]
  }
}

Zed

Config file: ~/.config/zed/settings.json

{
  "context_servers": {
    "praisonai": {
      "command": {
        "path": "uvx",
        "args": ["praisonai-mcp"]
      }
    }
  }
}

Claude Code (CLI)

claude mcp add praisonai -- uvx praisonai-mcp

---

Environment Variables

| Variable | Description | Required For | |----------|-------------|--------------| | OPENAI_API_KEY | OpenAI API key | Agent tools | | TAVILY_API_KEY | Tavily search API key | tavilysearch, tavilyextract | | EXA_API_KEY | Exa search API key | exasearch, exasearchcontents, exafindsimilar | | YDC_API_KEY | You.com API key | ydcsearch, ydcnews | | SEARXNG_URL | SearxNG instance URL | searxngsearch (optional) |

---

Running as SSE Server

python -m praisonai_mcp --sse --port 8080

---

Links

• 📖 Documentation
• 🐙 PraisonAI
• 📦 MCP Registry

License

MIT License

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: MervinPraison
• Source: MervinPraison/praisonai-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.