Skip to main content
Glama

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

Related MCP server: MCP Server Demo

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

License

MIT License

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MervinPraison/praisonai-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server