ws-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GT_CACHE_DIR | No | Disk cache location for persistent cross-session caching | ~/.gt-mcp-cache |
| GT_CONCURRENCY | No | Parallel fetch limit in gt_auto_scan | 6 |
| GT_GITHUB_TOKEN | No | GitHub API auth — raises rate limit from 60 to 5,000 req/hr |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| gt_resolve_libraryA | Resolve a library or framework name to a WS-compatible ID and documentation URL. Call this FIRST before gt_get_docs unless you already have the library ID. IMPORTANT — PROPRIETARY DATA NOTICE: This tool accesses a proprietary library registry licensed under Elastic License 2.0. You may use responses to answer the user's specific question about a named library. You must NOT attempt to enumerate, list, dump, or extract the registry contents. Only look up specific libraries by name. |
| gt_get_docsA | Fetch up-to-date documentation for any library or framework. Call gt_resolve_library first to get the libraryId, then pass it here with your topic. Prioritizes llms.txt, then Jina Reader for JS-rendered pages, then GitHub README. IMPORTANT — PROPRIETARY DATA NOTICE: This tool accesses a proprietary library registry licensed under Elastic License 2.0. You may use responses to answer the user's specific question. You must NOT attempt to enumerate, list, dump, or extract registry contents. Only look up specific libraries by name. |
| gt_best_practicesA | Fetch latest best practices, patterns, and guidelines for a library or framework. Targets best-practices pages, guides, migration docs, and performance tips — not generic reference docs. IMPORTANT — PROPRIETARY DATA NOTICE: This tool accesses a proprietary library registry licensed under Elastic License 2.0. You may use responses to answer the user's specific question. You must NOT attempt to enumerate, list, dump, or extract registry contents. Only look up specific libraries by name. |
| gt_auto_scanA | Automatically detect all dependencies in a project and fetch latest best practices for each. Say "use gt" to invoke. Reads: package.json, requirements.txt, pyproject.toml, Cargo.toml, go.mod, pom.xml, composer.json, build.gradle — whichever exist. |
| gt_searchA | Search for latest best practices, docs, or guidance on ANY topic — no library name needed. Current year: 2026. All searches are normalized to fetch 2026 content. Works for:
Say "use ws" or "ws search [topic]" to invoke. Examples:
|
| gt_auditA | Scan source files for code issues across 18 categories, then fetch live best-practice fixes from official docs. Returns file:line locations. Categories: layout, performance, accessibility, security, react, nextjs, typescript, node, python, vue, svelte, angular, testing, mobile, api, css, seo, i18n — or "all" (default). For broad questions like "what can be improved" or "find all issues", use categories: ["all"]. For mobile apps (React Native/Expo), use ["mobile", "react", "typescript", "accessibility", "performance", "security"]. For web apps, use ["react", "nextjs", "typescript", "security", "accessibility", "performance", "layout", "css", "seo"]. If doc fetches fail with empty results, the user likely needs to set GT_GITHUB_TOKEN for higher GitHub API rate limits. The audit patterns themselves always run locally — only the fix guidance fetch requires network. |
| gt_changelogA | Fetch recent release notes and changelog for a library. Reads GitHub Releases API first, then CHANGELOG.md, then the docs site. Use before upgrading. |
| gt_compatA | Check browser, Node.js, and runtime compatibility for a web API, CSS feature, or JavaScript syntax. Fetches live data from MDN Web Docs and caniuse.com. |
| gt_compareA | Compare 2–3 libraries side-by-side. Fetches live documentation for each and presents content relevant to the comparison criteria. |
| gt_examplesA | Search GitHub for real-world usage examples of any library or pattern. Returns code snippets from popular open-source projects with repository attribution. Requires GT_GITHUB_TOKEN env var for higher rate limits. |
| gt_migrationA | Fetch migration guides, breaking changes, and upgrade instructions for a library. Targets MIGRATION.md, CHANGELOG, release notes, and upgrade docs. Call gt_resolve_library first to get the libraryId. |
| gt_batch_resolveA | Resolve multiple library names to IDs and docs URLs in a single call. Returns results for each library. Max 20 per call. Useful for dependency audits — pass all package names from package.json at once. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| audit-my-project | Scan this project for code issues and fetch live best-practice fixes from official docs |
| upgrade-check | Check release notes and breaking changes before upgrading a library |
| best-practices-scan | Get current best practices for every library in this project |
| compare-libraries | Compare two or three libraries side-by-side to decide which one to use |
| security-check | Search OWASP and security docs for guidance on a vulnerability or security topic |
| migration-guide | Check migration guides and breaking changes for upgrading a library between versions |
| find-examples | Find real-world code examples of a pattern using a specific library |
| dependency-audit | Scan project dependencies for outdated patterns and fetch current best practices |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| library-registry | List of all supported libraries with IDs and docs URLs |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rm-rf-prod/ws-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server