Skip to main content
Glama
matheusfillipe

ircv3-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
IRCV3_MCP_CONFIG_DIRNoOverride the config directory path (default: ~/.config/ircv3-mcp)
IRCV3_MCP_SECRET_KEYNoEncryption key for secrets, used as alternative to keyfile

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
irc_list_networksA

List configured IRC networks. Each has a state: "connected" (live this session) or "idle" (configured but not connected yet). Idle is normal and not an error — an account connects automatically the first time you use any tool on it. Just use the tools; do not treat idle as a failure.

irc_statusB

Show the current connection status for an IRC account.

irc_read_historyB

Fetch recent messages from a channel or DM. Use msgid values from results for reply/react/redact.

irc_list_conversationsB

List channels and DMs that had activity in the given time window.

irc_list_membersB

List the current members of a channel with their mode prefixes.

irc_whoisC

Look up information about a nick on IRC.

irc_recent_eventsA

Return recent live IRC events buffered since this session connected: messages, joins/parts/quits, nick/topic/mode changes, and reaction TAGMSGs. To watch for new activity, poll this tool with since_seq set to the cursor returned by the previous call — you get only events after it. Filter by target (a channel or nick) and kinds. This is the live in-memory buffer; for older server-side history use irc_read_history.

irc_send_messageA

Send a message to a channel or user. Provide text (single line) or lines (multiline array). Use in_reply_to with a msgid to thread replies. On success returns { ok: true } and, when available, the server-assigned msgid (use it for follow-up reply/react/redact). ok: true means the server confirmed the send — trust it; do not re-read history to verify. A failed or unconfirmed send returns an error, never an empty result.

irc_reactA

Add or remove an emoji reaction on a message identified by its msgid.

irc_send_with_typingA

Send a message the way a person would: emit a typing notification, hold it for a short time proportional to the message length (about 90 words per minute by default, tunable with wpm), then send the message. Use this for direct conversation where a natural typing indicator is desirable; use irc_send_message when you just want to deliver text immediately. Returns { ok: true } and the msgid when available, same as irc_send_message.

irc_start_typingA

Send a typing notification (+typing=active) to a channel or user, signalling that a message is being composed. Clients show this for about 6 seconds, so call again to keep it alive while you work, then send the message or call irc_stop_typing. For one-shot human-like sends, prefer irc_send_with_typing.

irc_stop_typingA

Clear an active typing notification (+typing=done) for a channel or user without sending a message. Use this if you started typing with irc_start_typing but decided not to send.

irc_joinB

Join a channel, optionally with a key (password).

irc_partA

Leave a channel with an optional parting reason.

irc_mark_readA

Send a read marker up to the given timestamp for a target.

irc_redactA

Redact (delete) a message by its msgid. This is destructive and cannot be undone.

irc_send_rawA

Send a raw IRC protocol line. Destructive and unrestricted — use only when no higher-level tool fits.

Prompts

Interactive templates invoked by user choice

NameDescription
irc-guideComplete guide on using the IRC MCP server

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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/matheusfillipe/ircv3-mcp'

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