Tlon MCP Server
About
An MCP (Model Context Protocol) server that provides tools for interacting with Tlon agents.
Explore
- 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")
Clone the repository, run npm install, then configure environment variables (URBIT_SHIP, URBIT_CODE, URBIT_HOST, URBIT_PORT, MCP_TRANSPORT). Start with npm start (stdio transport by default) or set MCP_TRANSPORT=http for HTTP mode. Use natural language queries in an MCP client such as Claude Desktop to invoke the send-dm, read-dm-history, and list-contacts tools.
Once configured, you can use natural language commands:
Send a message to Brian
Show me my recent DM history with ~sampel-palnet
Who are my contacts?
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
