praisonai-mcp 0.1.1

MCP server that exposes PraisonAI tools for Claude Desktop, Cursor, and other MCP clients

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

• 📖 Documentation
• 🐙 PraisonAI
• 📦 MCP Registry

License

MIT License