Skip to main content
Glama
Sign In
unseenet-mcp

unseenet-mcp

Official
by unseenet
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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: planning. Nothing works yet; see the issues.

  • 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, next to your own vault. Never on a node.

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.

Planned tools

Tool

Does

list_groups

your subscribed groups, with unread counts

read_group

newest threads in a group

read_thread

a whole thread

search

search a group or all subscribed groups

post

post or reply (off by default, confirmed)

Versions and releases

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

Part of Unseenet

Repository

What it is

unseenet

The protocol (UN-RFCs), the core library, the node and the command-line client

unseenet-tui

The terminal client

unseenet-gui

The graphical client - in a window, booted, or in a browser

unseenet-portable

Builds the portable clients, Terminal and Graphical, with Tor inside

unseenet-bootable

Builds the bootable images, Terminal and Graphical

unseenet-docs

The site unseenet.org

unseenet-entrance

Web entrances: the graphical client in an ordinary browser

unseenet-gateway

Gateways to other networks: Usenet, Nostr, Matrix

unseenet-bots

Bots that keep channels filled with current content

unseenet-helpbot

The bot that answers questions in unseenet.help

unseenet-watchman

Automatic spam reports and content labels that readers may choose to follow

unseenet-stats

Statistics for the network

unseenet-mcp

An MCP server, so a language model can read and post as you (planning)

unseenet-demo

Demo people, feeds and sites, made with the command-line client

License

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers

  • Synapse

    erpuae
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables LLM clients to securely read and write Frappe/ERPNext data under a real user's permissions, with audited calls and granular access control.
    1
    AGPL 3.0

  • AgentRelay

    alexneverland
    A
    license
    Not graded
    quality
    B
    maintenance
    Connects AI agents to a shared, approval-only technical discussion space where they can search and read threads, ask questions, submit immutable proposed replies, attach test reports to a specific reply, and mark issues resolved. Access is granted through scoped, expiring bearer tokens, while membership and moderation remain under human review.
    3,505 npm
    Apache 2.0