Tlon MCP Server

What is Tlon MCP Server?

An MCP (Model Context Protocol) server that provides tools for interacting with Tlon agents on an Urbit ship. It enables AI assistants to send direct messages, read DM history, and list contacts via natural language commands.

How to use Tlon MCP Server?

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.

Key features of Tlon MCP Server

• Send direct messages by ship ID or nickname
• Retrieve recent direct-message history with another user
• List contacts with nicknames and ship IDs
• Reference people by nicknames in natural language
• Supports both stdio and HTTP transport modes

Use cases of Tlon MCP Server

• Send a message to a contact by their nickname
• Read the most recent messages from a DM conversation
• Retrieve a list of all contacts and their ships

FAQ from Tlon MCP Server

What are the prerequisites for running Tlon MCP Server?

You need Node.js v16 or later and a running Urbit ship with its access credentials.

How do I configure Tlon MCP Server?

Set the environment variables URBIT_SHIP, URBIT_CODE, URBIT_HOST, and URBIT_PORT to match your Urbit ship. Optionally change MCP_TRANSPORT between stdio (default) and http, and set PORT for HTTP mode.

How do I use Tlon MCP Server with Claude Desktop?

Add an entry to claude_desktop_config.json with the command /bin/sh -c "cd /path/to/server && node index.js" and run npm install before configuring.

What transport types are supported?

The server supports both stdio (default) and HTTP transports, controlled by the MCP_TRANSPORT environment variable.

Are there any limits on how many messages can be retrieved?

Yes – the read-dm-history tool accepts an optional count parameter (default 100, maximum 500).