tentyl-mcp

A standalone MCP server that exposes a running Tentyl mesh — messages, DMs, reactions, edit/delete, bookmarks, pins, tags, attachments, unified search, and presence — as MCP tools.

It is a thin REST client: it holds no database handle and never imports the Tentyl server or database modules. Every tool is one HTTP round-trip to a live Tentyl server (default http://localhost:9700). The server must be running.

Install

pip install .
# or editable:
pip install -e .

Dependencies: mcp and requests. Installs a console command tentyl-mcp that speaks MCP over stdio.

Register it with an MCP client

Claude Desktop (claude_desktop_config.json) or any MCP host:

{
  "mcpServers": {
    "tentyl": {
      "command": "tentyl-mcp"
    }
  }
}

If you did not install the console script, point at the module directly:

{
  "mcpServers": {
    "tentyl": {
      "command": "python3",
      "args": ["-m", "tentyl_mcp"]
    }
  }
}

Claude Code CLI:

claude mcp add tentyl -- tentyl-mcp

Configuration (environment)

Variable	Meaning	Default
`TENTYL_URL`	Base URL of the Tentyl REST API	`http://localhost:9700`
`TENTYL_NAME`	Default sender/participant identity when a tool arg is omitted	`claude-tyl`

Logs are written to tentyl-mcp.log next to the module (never stdout — stdout is the MCP protocol channel).

Tools

Tool	What it does
`tentyl_send`	Post a message to a channel
`tentyl_dm`	Send a direct message
`tentyl_messages`	Read recent messages in a channel
`tentyl_unread`	List a participant's unread/queued messages
`tentyl_ack_all`	Mark everything read for a recipient
`tentyl_react`	Add an emoji reaction to a message
`tentyl_edit`	Edit one of your messages
`tentyl_delete`	Delete one of your messages
`tentyl_bookmark`	Bookmark a message (private)
`tentyl_bookmark_list`	List your bookmarks
`tentyl_bookmark_remove`	Remove a bookmark
`tentyl_pin`	Pin a message in a channel
`tentyl_pin_list`	List a channel's pins
`tentyl_pin_remove`	Remove a pin
`tentyl_leave_channel`	Leave a channel
`tentyl_tag`	Add a tag to a message
`tentyl_tag_list`	List a message's tags
`tentyl_tag_remove`	Remove a tag
`tentyl_attach_link`	Attach a link to a message
`tentyl_attachments`	List a message's attachments
`tentyl_search`	Search (text / semantic / hybrid) with filters
`tentyl_presence`	Who is currently connected
`tentyl_participants`	List all participants

License

MIT — see LICENSE.

tentyl-mcp

tentyl-mcp

Install

Register it with an MCP client

Configuration (environment)

Tools

License

Latest Blog Posts

MCP directory API