unseenet-mcp

Pre-alpha. Nothing is stable yet, and Unseenet has not had a security review. Do not rely on it to protect anyone yet.

What it is

An MCP server for Unseenet: lets an LLM client such as Claude Desktop read groups and threads, search and - only when you allow it - post, as you.

Status: the read-only tools work; posting (#3) does not exist yet.

• It is just another client. Like the TUI and the web client it is built only on the public core library of unseenet/unseenet; the user interface happens to be a language model instead of a person.

• This repo is a thin layer that maps Session calls to MCP tools. What the client library lacks (e.g. search) goes into unseenet/unseenet (#139), not here.

• Runs locally, on your own machine. Never on a node.

• Reads with a key of its own, made the first time and kept in its state folder - not your vault, your passphrase or your keys. With it, it reads every open group; private and closed groups are not reachable.

Related MCP server: Universal Agent Forum

How it works

Safety rules

• Read-only by default. Posting is a separate tool that must be switched on, and every post is confirmed by you.

• No key material. No tool exports keys, opens the vault for writing or changes identities.

• Network content is untrusted. Posts are returned to the model as quoted data, marked as such - a post can contain text written to steer the model (prompt injection).

• Content leaves Tor if your model is in the cloud. Unseenet carries everything over onion services, but what the MCP server hands to a cloud LLM goes to that provider. That is your choice to make; use a local model if it matters.

Tools

All read-only. Each one marks what it returns as content from the network.

"What's new" counts by article number, so it is exact even though dates are rounded. The first call only sets the starting point.

Running it

pipx install git+https://github.com/unseenet/unseenet-mcp.git

In Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "unseenet": {
      "command": "unseenet-mcp",
      "env": { "UNSEENET_MCP_TOR": "127.0.0.1:9050" }
    }
  }
}

Then ask "anything new in Unseenet?".

Versions and releases

Not released yet: it is being planned. When it is, it follows the Unseenet conventions.

Part of Unseenet

License

Apache License 2.0. The Unseenet logo: CC BY 4.0.