freeq MCP server

freeq

IRC server and client with AT Protocol (Bluesky) identity authentication, end-to-end encrypted channels, iroh QUIC transport, peer-to-peer DMs, and federated server-to-server clustering.

Users authenticate with their Bluesky identity via a custom SASL mechanism (ATPROTO-CHALLENGE). Standard IRC clients connect as guests. Authenticated users get their DID bound to their connection — visible via WHOIS, enforced for nick ownership, and usable for DID-based bans, invites, and persistent ops.

Try it now: irc.freeq.at

For agents

freeq is meant to be used by software as well as people, so every surface an agent looks for exists and cross-links the others:

raw markdown (llms-full.txt for one fetch).

• llms.txt — the documentation index, linking

contract (spec/openapi.yaml; a drift test fails the build if the router and the spec disagree).

• OpenAPI 3.1 — the full HTTP

to read, search, verify and take part in conversations. Not on npm yet: build it (cd freeq-mcp && npm install && npm run build) and point your client at node /freeq-mcp/dist/index.js.

• MCP — freeq-mcp/ (@freeq/mcp) gives any MCP client tools

other people's agents), freeq-api (REST), freeq-bots (building one).

• Skills — skills/: freeq (talking to

— ask the server why a join failed or a message went missing; it answers with a conclusion plus evidence, not raw state.

• Agent Assistance Interface

Attribution is the point: every message carries a ULID msgid and a signature, and GET /api/v1/verify/{msgid} distinguishes a message signed by its author's key from one merely relayed by the server.

Web Client

The web client at irc.freeq.at provides:

• AT Protocol OAuth login — sign in with your Bluesky identity
• Channel policy gates — channels can require credential verification to join
• GitHub verification — prove repo collaborator or org membership status
• Bluesky social graph gates — prove you follow someone (no OAuth needed)
• Moderator appointments — ops issue signed credentials for halfop (+h)
• Automatic role escalation — credentials auto-grant IRC modes (op, halfop, voice)
• Shareable invite links — https://irc.freeq.at/join/#channel
• Message editing, deletion, reactions, threads — changing a message requires the sender's signature; current clients sign automatically
• End-to-end encrypted channels

Demo Channels

Architecture

freeq-server/       IRC server with SASL, WebSocket, iroh, S2S federation
freeq-app/          React web client (Vite + Tailwind)
freeq-auth-broker/  AT Protocol OAuth broker (persistent sessions)
freeq-sdk/          Reusable client SDK (connect, auth, events, E2EE, P2P)
freeq-tui/          Terminal UI client built on the SDK
freeq-site/         Marketing site (freeq.at)

The SDK exposes a (ClientHandle, Receiver) pattern — any UI or bot can consume events and send commands.

Transport Stack

Shortened. The full README is on GitHub.