trackmcp
Back to directory
MervinPraison

praisonai-mcp

View on GitHub

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

1 stars PythonOthers Updated Mar 13, 2026

Documentation

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

bash
# 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:

ToolDescription
`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:

ToolDescription
`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:

ToolDescription
`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:

ToolDescription
`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

ToolDescription
`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

ToolDescription
`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

ToolDescription
`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

ToolDescription
`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

ToolDescription
`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

ToolDescription
`get_stock_price`Get current stock price
`get_stock_history`Get historical stock data

🖼️ Image & Query

ToolDescription
`analyze_image`Analyze image using vision
`rewrite_query`Rewrite query for better results
`expand_prompt`Expand short prompt to detailed

✅ Task Management

ToolDescription
`todo_add`Add task to todo list
`todo_list`List all tasks
`todo_complete`Mark task as completed

💾 Session & State

ToolDescription
`session_save`Save current session
`session_load`Load a saved session
`session_list`List all sessions

📜 Rules & Guardrails

ToolDescription
`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

ToolDescription
`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

ToolDescription
`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)

json
{
  "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`

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`

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

Windsurf

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

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:

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

Continue

Config file: `~/.continue/config.json`

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

Zed

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

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

Claude Code (CLI)

bash
claude mcp add praisonai -- uvx praisonai-mcp

Environment Variables

VariableDescriptionRequired For
`OPENAI_API_KEY`OpenAI API keyAgent tools
`TAVILY_API_KEY`Tavily search API keytavily_search, tavily_extract
`EXA_API_KEY`Exa search API keyexa_search, exa_search_contents, exa_find_similar
`YDC_API_KEY`You.com API keyydc_search, ydc_news
`SEARXNG_URL`SearxNG instance URLsearxng_search (optional)

Running as SSE Server

bash
python -m praisonai_mcp --sse --port 8080

Links

License

MIT License

Frequently asked questions

What is praisonai-mcp?

praisonai-mcp is MCP server that exposes PraisonAI tools for Claude Desktop, Cursor, and other MCP clients

How do I install praisonai-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is praisonai-mcp open source?

Yes — it is hosted on GitHub at https://github.com/MervinPraison/praisonai-mcp and has 1 stars.

Related MCP tools

topoteretescognee

Cognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.

30,433 Python
agent-memoryagent-skillsai+16
Skyvern-AIskyvern

Automate browser based workflows with AI

22,930 Python
apiautomationbrowser+13
vectorize-iohindsight

Hindsight: Agent Memory That Learns

22,468 Python
agentic-aimemoryagents+1
guillaumemeyerwatermarks-remover

A privacy-first app that strips AI watermarks from content you own.

20,504 Python
agent-skillaic2pa+12
QwenLMQwen-Agent

Agent framework and applications built upon Qwen>=3.0, featuring Function Calling, MCP, Code Interpreter, RAG, Chrome extension, etc.

17,062 Python
BeehiveInnovationspal-mcp-server

The power of Claude Code / GeminiCLI / CodexCLI + [Gemini / OpenAI / OpenRouter / Azure / Grok / Ollama / Custom Model / All Of The Above] working as one.

11,731 Python

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP