Tlon MCP Server

An MCP (Model Context Protocol) server that provides tools for interacting with Tlon agents.

Demo

https://github.com/user-attachments/assets/765847b2-df40-44c0-bfd3-c23eb609bbd8

Features

- send-dm tool: Send direct messages to other users by ship ID or nickname
- read-dm-history tool: Retrieve recent messages from a direct-message channel
- list-contacts tool: Get contacts with their nicknames and ship IDs
- Natural language support: Reference people by their nicknames ("Send a message to Brian")

Prerequisites

- Node.js (v16+)
- A running Urbit ship

Installation

1. Clone the repository
2. Navigate to the project directory
3. Install dependencies:

npm install

Important: Always run npm install manually in the terminal before using with Claude Desktop or any other MCP client. This prevents installation output from interfering with the MCP protocol.

Configuration

Configure the server using environment variables:

| Variable | Description | Default |
| --------------- | -------------------------------- | --------------------------- |
| URBIT_SHIP | Your Urbit ship name (without ~) | zod |
| URBIT_CODE | Your Urbit +code | lidlut-tabwed-pillex-ridrup |
| URBIT_HOST | Urbit host | localhost |
| URBIT_PORT | Urbit port | 8080 |
| PORT | MCP server port (HTTP mode only) | 3001 |
| MCP_TRANSPORT | Transport type (http or stdio) | stdio |

Usage

Starting the server

```bash