MCP.so
Sign In

Tlon MCP Server

@jamesacklin

Basic information

Category

Other

Transports

stdio

Author

jamesacklin

About Tlon MCP Server

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

Tlon MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tlon MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

1

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.

2

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.

3

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.

4

What transport types are supported?

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

5

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).

Comments

More Other MCP servers