Is Soulshack safe to use?

Soulshack has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under GPL-3.0.

How do I install Soulshack?

Soulshack can be installed by cloning its GitHub repository and following the setup instructions in the README.

What can Soulshack do?

Soulshack provides 11 tools: irc_op, irc_deop, irc_kick, irc_ban, irc_unban and 6 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Soulshack?

Soulshack is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is Soulshack actively maintained?

Soulshack is recently maintained — last commit was 38 days ago. It has 29 GitHub stars.

Soulshack

Name: Soulshack
Author: pkdindustries

by pkdindustries

soulshack, an irc chatbot. openai/ollama/gemini/anthropic apis. basic shell tools and mcp server support.

29 11 tools GitHub

No known CVEs

GPL-3.0 license

Maintained

Last commit 38d ago

Works with most clients

Transport: stdio, sse, http

11 tools · ~406 tok

Grade A · 0.2% of 200K ctx

Edit this pageView history

Communication AI / ML

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "soulshack": {
      "command": "<see-readme>",
      "args": []
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/soulshack)](https://mcppedia.org/s/soulshack)

Read me

What Soulshack does

Soulshack is an advanced IRC chatbot powered by LLMs, designed to bridge traditional chat with modern AI capabilities.

Test This Server

No automated test available for this server. Check the GitHub README for setup instructions.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

70/100across 5 weighted dimensions

How we score →

0255075100

−30

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (11)

Click any tool to inspect its schema.

~406 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Soulshack safe to use?: Soulshack has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under GPL-3.0.
How do I install Soulshack?: Soulshack can be installed by cloning its GitHub repository and following the setup instructions in the README.
What can Soulshack do?: Soulshack provides 11 tools: irc_op, irc_deop, irc_kick, irc_ban, irc_unban and 6 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Soulshack?: Soulshack is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is Soulshack actively maintained?: Soulshack is recently maintained — last commit was 38 days ago. It has 29 GitHub stars.

Similar servers

Others in communication / ai-ml

View all →

Memory MCP Server98

Persistent memory using a knowledge graph

86.4k 5

Sequential Thinking MCP Server98

Dynamic problem-solving through sequential thought chains

86.4k 1

Mcp_agent_mail96

Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite

2.0k 6

Antigravity Workspace Template96

Workspace template + MCP server for Claude Code, Codex CLI, Cursor & Windsurf. Multi-agent knowledge engine (ag-refresh / ag-ask) that turns any codebase into a queryable AI assistant.

1.2k 2

MCP Security Weekly

Get CVE alerts and security updates for Soulshack and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Communication AI / ML

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "soulshack": {
      "command": "<see-readme>",
      "args": []
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/soulshack)](https://mcppedia.org/s/soulshack)

Read me

What Soulshack does

Soulshack is an advanced IRC chatbot powered by LLMs, designed to bridge traditional chat with modern AI capabilities.

Test This Server

No automated test available for this server. Check the GitHub README for setup instructions.

README

Soulshack User Guide

Soulshack is an advanced IRC chatbot powered by LLMs, designed to bridge traditional chat with modern AI capabilities.

Features

Multi-Provider Support: Works with OpenAI, Anthropic, Google Gemini, and Ollama.
Unified Tool System: Supports shell scripts, MCP servers, and native IRC tools.
Secure: Full SSL/TLS and SASL authentication support.
Session Management: Configurable history, context window, and session TTL.
Streaming: Real-time responses with IRC-appropriate chunking.
Passive Mode: Optional URL watching and analysis.
Runtime Configuration: Manage settings via IRC commands.

Quickstart

Option 1: Docker

docker build . -t soulshack:dev

Option 2: Build from Source

Prerequisites: Go 1.23+

Clone and Build:

git clone https://github.com/pkdindustries/soulshack.git
cd soulshack
go build -o soulshack cmd/soulshack/main.go

Run:

Configuration File (Recommended)

Local Binary:

./soulshack --config examples/chatbot.yml

Docker:

# Mount config file to container
docker run -v $(pwd)/examples/chatbot.yml:/config.yml soulshack:dev \
  --config /config.yml

All Flags (Kitchen Sink)

Local Binary:

./soulshack \
  --nick soulshack \
  --server irc.example.com \
  --port 6697 \
  --tls \
  --channel '#soulshack' \
  --saslnick mybot \
  --saslpass mypassword \
  --admins "admin!*@*" \
  --model openai/gpt-5.1 \
  --openaikey "sk-..." \
  --maxtokens 4096 \
  --temperature 1 \
  --apitimeout 5m \
  --tool "examples/tools/datetime.sh" \
  --tool "irc__op" \
  --thinkingeffort off \
  --urlwatcher \
  --verbose

Docker:

docker run soulshack:dev \
  --nick soulshack \
  --server irc.example.com \
  --port 6697 \
  --tls \
  --channel '#soulshack' \
  --saslnick mybot \
  --saslpass mypassword \
  --admins "admin!*@*" \
  --model openai/gpt-5.1 \
  --openaikey "sk-..." \
  --maxtokens 4096 \
  --temperature 1 \
  --apitimeout 5m \
  --thinkingeffort off \
  --urlwatcher \
  --verbose
# Note: Local file tools/scripts require volume mounts to work in Docker

Ollama (Local)

Local Binary:

./soulshack \
  --server irc.example.com \
  --channel '#soulshack' \
  --model ollama/qwen3:30b \
  --ollamaurl "http://localhost:11434"

Docker:

# Use --network host to access Ollama on localhost
docker run --network host soulshack:dev \
  --server irc.example.com \
  --channel '#soulshack' \
  --model ollama/qwen3:30b \
  --ollamaurl "http://localhost:11434"

Anthropic

Local Binary:

./soulshack \
  --server irc.example.com \
  --channel '#soulshack' \
  --model anthropic/claude-opus-4.5 \
  --anthropickey "sk-ant-..."

Docker:

docker run soulshack:dev \
  --server irc.example.com \
  --channel '#soulshack' \
  --model anthropic/claude-opus-4.5 \
  --anthropickey "sk-ant-..."

Configuration Flags

Flag	Default	Description
`-n, --nick`	soulshack	Bot nickname
`-s, --server`	localhost	IRC server address
`-p, --port`	6667	IRC server port
`-c, --channel`		Channel to join
`-e, --tls`	false	Enable TLS
`--tlsinsecure`	false	Skip TLS cert verification
`--saslnick`		SASL username
`--saslpass`		SASL password
`-b, --config`		Path to YAML config file
`-A, --admins`		Comma-separated admin hostmasks
`-V, --verbose`	false	Enable debug logging
`--mo

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

70/100across 5 weighted dimensions

How we score →

0255075100

−30

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (11)

Click any tool to inspect its schema.

~406 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Soulshack safe to use?: Soulshack has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under GPL-3.0.
How do I install Soulshack?: Soulshack can be installed by cloning its GitHub repository and following the setup instructions in the README.
What can Soulshack do?: Soulshack provides 11 tools: irc_op, irc_deop, irc_kick, irc_ban, irc_unban and 6 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Soulshack?: Soulshack is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is Soulshack actively maintained?: Soulshack is recently maintained — last commit was 38 days ago. It has 29 GitHub stars.

Similar servers

Others in communication / ai-ml

View all →

Memory MCP Server98

Persistent memory using a knowledge graph

86.4k 5

Sequential Thinking MCP Server98

Dynamic problem-solving through sequential thought chains

86.4k 1

Mcp_agent_mail96

Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite

2.0k 6

Antigravity Workspace Template96

Workspace template + MCP server for Claude Code, Codex CLI, Cursor & Windsurf. Multi-agent knowledge engine (ag-refresh / ag-ask) that turns any codebase into a queryable AI assistant.

1.2k 2

MCP Security Weekly

Get CVE alerts and security updates for Soulshack and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?