TGlider

TGlider is a semantic TypeScript and JavaScript MCP server for code navigation, workspace intelligence, dependency topology, diagnostics, and refactoring.

Requirements

• Node.js 24 or newer.
• An MCP client that can launch stdio servers or connect to Streamable HTTP.
• A TypeScript or JavaScript workspace using tsconfig.json, jsconfig.json, or an inferred JS/TS project.

MCP Configuration

Use the stable package for normal MCP client configuration:

{
  "mcpServers": {
    "tglider": {
      "command": "npx",
      "args": ["-y", "tglider"]
    }
  }
}

Use installation and host-specific setup guides on the website:

• https://glidermcp.com/tglider/installation
• https://glidermcp.com/tglider/installation/codex
• https://glidermcp.com/tglider/installation/claude-code
• https://glidermcp.com/tglider/installation/copilot

LLM Agent System Prompt

After connecting the server, add this instruction to the MCP client system prompt so the agent uses compiler-backed workspace facts before raw text search:

When working in TypeScript or JavaScript workspaces, prefer tglider mcp semantic tools before grep, rg, or find for code navigation and refactoring. Use TGlider for symbols, declarations, references, implementations, exports, package importers, project and dependency topology, diagnostics, callers, outgoing calls, impact analysis, and preview-first rename or refactor planning. Use shell text search only for non-code assets, files outside the loaded workspace, generated output, or after TGlider cannot load or cannot answer the question. Preload the workspace at startup with --workspace (or call load first); the load is a one-time background cost, so do not fall back to text search just because loading a large workspace seems slow.

CLI Arguments

tglider --help
tglider --version
tglider
tglider --transport http --port 5002
tglider --default-timeout 30m
tglider --workspace /path/to/repo

Running tglider without flags starts the MCP stdio server. Running tglider --transport http starts Streamable HTTP at /mcp and a health endpoint at /health. --default-timeout supports ms, s, and m suffixes. Use 0 to disable server-side tool timeouts. --workspace <dir> preloads a workspace root (a directory) at startup, skipping the load-tool round-trip so server_status reflects it from the first message — loading in the background under workspaceLoading, then loaded — and the agent can wait for that load instead of stopping because nothing is loaded. Add --no-watch to load without starting the file watcher. In an MCP config, append it to the launch args (for example "args": ["-y", "tglider", "--workspace", "/path/to/repo"]).

Text Search

TGlider has no text-search tool. Its tools are compiler-backed, and they answer semantic questions about TypeScript and JavaScript. For literal and regular-expression text hunts — comments, strings, and configuration files — use your client's own search, or a dedicated search server such as Scout added to your MCP configuration alongside TGlider.

Tool Overview

TGlider exposes MCP tools for:

• workspace loading, project metadata, and package workspace detection
• file reads, file structure summaries, diagnostics, and diagnostic hotspots
• semantic symbol search, symbol lookup at position, definitions, declarations, references, implementations, and type hierarchies
• project dependency topology, dependency paths, file dependents, and cycles
• API/export discovery and compact semantic queries
• call graph inspection, cascade impact summaries, conservative unused-code discovery, preview-first rename/refactor planning, and language-service formatting
• live document open/update/close workflows for editors and agents

Version Expiration Notice

TGlider packages include release metadata and expire 30 days after their release date. The recommended npx -y tglider MCP configuration resolves the current package when the client launches the server. tglider --help and tglider --version continue to work after expiry.

License

Free for personal use, open-source work, education, and a 30-day organizational evaluation under the GliderMCP EULA. Commercial use requires a paid license once plans are on sale; until then the EULA permits it free of charge. The full terms are in the LICENSE file inside this package.