Tlon

Provides tools to interact with Tlon agents via MCP, including sending DMs, reading DM histories, and listing contacts.

javascript

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jamesacklin-tlon-mcp-server": {
      "command": "/bin/sh",
      "args": [
        "-c",
        "cd /path/to/server && node index.js"
      ],
      "env": {
        "PORT": "3001",
        "URBIT_CODE": "lidlut-tabwed-pillex-ridrup",
        "URBIT_HOST": "localhost",
        "URBIT_PORT": "8080",
        "URBIT_SHIP": "zod",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

The Tlon MCP Server provides practical tools to interact with Tlon agents via the MCP protocol. It lets you send direct messages, fetch DM histories, and manage contacts using natural language or explicit commands, all through a lightweight HTTP or stdio-based server that your MCP client can connect to.

How to use

You interact with the server through an MCP client. Start the server in stdio mode to run locally, or use HTTP transport if you have a remote MCP endpoint. With a configured client, you can perform tasks such as sending DMs, retrieving recent messages, and listing your contacts. You can also use natural language phrases like “Send a message to Brian” to invoke the corresponding tools.

How to install

prerequisites: Node.js v16+ and a running Urbit ship.

Step 1: Clone the project directory.

Step 2: Navigate to the project directory.

npm install

Configuration and startup notes

Configure environment variables to connect to your Urbit ship and to set up the MCP server port and transport. You can run the server in stdio mode (default) or switch to HTTP transport when needed.

export URBIT_SHIP=zod
export URBIT_CODE=lidlut-tabwed-pillex-ridrup
export URBIT_HOST=localhost
export URBIT_PORT=8080
export PORT=3001
export MCP_TRANSPORT=_stdio

Using Claude Desktop integration (example setup)

You can configure Claude Desktop to launch the MCP server from a local path. Use a shell command to start the server from your project directory.

{
  "mcpServers": {
    "tlon-mcp": {
      "command": "/bin/sh",
      "args": ["-c", "cd /path/to/server && node index.js"]
    }
  }
}

Available tools

send-dm

Sends a direct message to another ship. You provide the recipient (ship name with ~ or a nickname) and the message text.

read-dm-history

Fetches recent messages from a direct-message channel with a specified correspondent. You can limit the number of messages and choose a raw or formatted output.

list-contacts

Retrieves your contacts list, including ship IDs and nicknames, with an option to format the output.

natural-language

Supports natural language commands to perform actions like sending messages by nickname or ship name.

Built by

VeilStrat

AI signals for GTM teams