MervinPraison/praisonai-mcp

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	tavily_search, tavily_extract
EXA_API_KEY	Exa search API key	exa_search, exa_search_contents, exa_find_similar
YDC_API_KEY	You.com API key	ydc_search, ydc_news
SEARXNG_URL	SearxNG instance URL	searxng_search (optional)

---

Running as SSE Server

python -m praisonai_mcp --sse --port 8080

---

Links

• 📖 Documentation
• 🐙 PraisonAI
• 📦 MCP Registry

License

MIT License