Skip to main content
CLI Reference

travsr mcp

Start the MCP server. The default transport is stdio (for local Claude Desktop use). SSE transport is used for Travsr Cloud.

Synopsis

travsr mcp [--stdio | --sse] [flags]

Transports

stdio (default)

travsr mcp --stdio

The server reads JSON-RPC 2.0 from stdin and writes to stdout. Claude Desktop spawns this as a subprocess: you do not run it manually.

Claude Desktop config (claude_desktop_config.json):

{
"mcpServers": {
"travsr": {
"command": "travsr",
"args": ["mcp", "--stdio"]
}
}
}

SSE

travsr mcp --sse [--port <n>] [--host <addr>]
FlagDefaultDescription
--port <n>3001HTTP port
--host <addr>127.0.0.1Bind address
--auth-token <token>N/ARequire bearer token on all requests

The SSE server exposes:

  • GET /sse: Server-Sent Events stream (MCP messages)
  • POST /message: Client-to-server messages

Flags (common)

FlagDefaultDescription
--repo <path>cwdRepository root to serve
--db <path>.travsr/graph.dbGraph database path

Example output (stdio startup)

$ travsr mcp --stdio
{"jsonrpc":"2.0","method":"initialize","result":{"name":"travsr","version":"0.9.0","capabilities":{"tools":{}}}}

After this, Claude Desktop takes over stdin/stdout.