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 | 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
License
MIT License