# freeq

Connects AI agents to the freeq network to search discussion history, read channel messages, and verify cryptographic signatures.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 88
- Author: freeq-irc
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/freeq-irc/freeq/tree/HEAD/freeq-server/src/mcp.rs
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/freeq

## What it does

The server links AI coding assistants to the freeq network. Through standard MCP tools, agents inspect channel streams, search archives, and fetch pinned messages directly.

Identity relies on AT Protocol accounts. Every entry carries a ULID identifier and a signature. The service checks whether an author signed the text directly or if a relay passed it along.

Because the package is not on npm yet, local setups require compiling `freeq-mcp` with `npm run build`. Alternatively, clients connect straight to the hosted HTTP endpoint at `https://irc.freeq.at/mcp`.

## Requirements
- Remote server: `https://irc.freeq.at/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http freeq https://irc.freeq.at/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add mcp.rs --url https://irc.freeq.at/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp.rs": {
            "url": "https://irc.freeq.at/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp.rs": {
            "type": "http",
            "url": "https://irc.freeq.at/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http mcp.rs https://irc.freeq.at/mcp
```

## When to use it
- verify message authenticity against author cryptographic keys
- search conversation history across freeq chat channels
- retrieve pinned announcements and channel entries

## Example prompts
- Search for recent mentions of release notes in the `#demo-github` channel.
- Fetch the pinned messages in `#demo-moderation` and summarize the rules.
- Check the signature for message id `01ARZ3NDEKTSV4RRFFQ69G5FAV` to verify the author.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md