dust

A TypeScript MCP server bridging Dust.tt agents with external tools via JSON-RPC, SSE, and secure API integration. Implements MCP specs/sdk for Claude Desktop compatibility, featuring session management, real-time streaming, and Dust API connectivity.

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

View docs

Command

claude mcp add --transport stdio ma3u-dust-mcp-server node server.js \
  --env REDIS_TLS="false" \
  --env REDIS_URL="redis://localhost:6379" \
  --env SESSION_TTL="86400" \
  --env REDIS_ENABLED="true" \
  --env REDIS_PASSWORD="" \
  --env SESSION_SECRET="your_session_secret_here"

How to use

Dust MCP Server provides a standardized MCP interface for interacting with Dust.tt agents. It enables agent discovery, session management, and message routing between clients like Claude Desktop via STDIO. The server exposes REST-like endpoints for session handling and uses Redis for persistent session storage, while offering a straightforward command-line startup that forwards to a Node.js server entrypoint (server.js). You can use the included tools to create and manage user sessions, query available agents, configure workspace and agent interactions, and monitor session health across distributed deployments. Typical workflows involve starting the server, establishing a session for a user, and then issuing MCP commands to discover agents, initialize workspaces, and coordinate multi-agent tasks through the MCP protocol.

How to install

Prerequisites:

Node.js v18 or later
npm 9.x or later
Redis server (for session management)
A Dust.tt account with API access (for agent data if required)

Install dependencies (from repository or npm):

Clone the repository: git clone https://github.com/your-org/dust-mcp-server.git cd dust-mcp-server
Install Node.js dependencies: npm install

Configure environment:

Create a .env file or set environment variables as shown below. Typical defaults are: REDIS_ENABLED=true REDIS_URL=redis://localhost:6379 REDIS_PASSWORD= REDIS_TLS=false SESSION_SECRET=your_session_secret_here SESSION_TTL=86400

Start the server:

Basic startup: node server.js

Optional: install via npm (if published):

npm install -g ma3u-dust-mcp-server
Start (example): node server.js

Prerequisites and notes:

Ensure Redis is running and accessible at the configured REDIS_URL, especially in production environments.
If Redis is not used for development, set REDIS_ENABLED=false to switch to an in-memory session store.
Ensure you have appropriate permissions and network access for the Dust.tt API if the server relies on external agent data.

Additional notes

Tips and common issues:

Redis connection issues: verify the Redis service is up and accessible at the URL provided in REDIS_URL. Check REDIS_PASSWORD if authentication is enabled.
Session TTL: adjust SESSION_TTL to balance persistence and security for your deployment.
Redis TLS: set REDIS_TLS=true if your Redis instance requires TLS; update REDIS_URL accordingly.
When running in multiple instances, ensure Redis is properly clustered and shared across instances to maintain consistent sessions.
If Redis is disabled for development, the server will use an in-memory store; note that this is not suitable for production.
Logging: monitor server logs for session-related errors and MCP handshake messages to diagnose connectivity issues with clients like Claude Desktop.