augmnt/augments-mcp-server

mcp-name: dev.augments/mcp
What's New in v7
**Version 7.0** is the biggest upgrade yet — documentation-first search, 4 new tools, BM25 indexing, and production-grade reliability.
| v6 | v7 |
|----|-----|
| 3 tools | 8 tools (+ diagnostics) |
| Types-only search | Documentation-first BM25 search |
| 8 concept synonyms | 25 concept synonym clusters |
| Generic version diffs | Real changelog-backed breaking changes |
| No migration guides | Cross-version migration guides |
| No error diagnosis | Curated error patterns + GitHub Issues |
| No package comparison | Side-by-side package comparison |
| No dep scanning | Dependency scanner (outdated/deprecated/security) |
| FIFO caches | LRU caches with hit/miss stats |
| Fixed retry delays | Exponential backoff + circuit breaker |
Quick Start
Claude Code
Cursor
Add to your MCP config:
Environment Variables
Set GITHUB_TOKEN for higher GitHub API rate limits when fetching examples and documentation:
Usage
Tools
| Tool | Description |
|------|-------------|
| get_api_context | **Primary tool.** Returns API signatures, prose documentation, and code examples for any npm package. Handles natural language queries with intent detection. Now with documentation-first BM25 search. |
| search_apis | Search for APIs across frameworks by keyword or concept. 25 synonym clusters ("state" matches useState, createStore, atom, etc). |
| get_version_info | Get npm version info, compare versions, and detect breaking changes backed by real changelogs. |
| get_migration_guide | **New.** Cross-version migration guide with breaking changes, new features, deprecations, type diffs, and official migration docs. |
| diagnose_error | **New.** Diagnose errors using curated patterns, GitHub Issues search, and troubleshooting docs. |
| compare_packages | **New.** Compare 2-5 npm packages: downloads, bundle size, GitHub stars, dependencies, exported APIs. |
| scan_project_deps | **New.** Scan package.json for outdated, deprecated, and insecure dependencies. |
| diagnostics | Server health: version, uptime, memory, cache stats, Node.js version. |
Architecture
Source Structure
Key Features
Documentation-First Search (New in v7)
Queries like "prisma findMany with pagination" and "zustand create store with middleware" now return real documentation content. The BM25 search engine indexes docs fetched from GitHub by heading-based chunks, with API name boosting and synonym expansion.
Concept Synonyms
25 synonym clusters cover state, form, fetch, animation, routing, auth, cache, effect, middleware, pagination, validation, testing, streaming, error handling, database, layout, modal, table, upload, realtime, deployment, i18n, SSR, component, and context patterns. Bidirectional lookup means "usestate" expands to the "state" cluster.
Intent-Aware Formatting
| Intent | Trigger | Format |
|--------|---------|--------|
| howto | "how to", "example of", "guide" | Examples → prose → brief signature |
| reference | "signature", "types", "parameters" | Full signature → related types → 1 example |
| migration | "migrate", "upgrade", "breaking" | Prose → signature → examples |
| balanced | Default | Signature → prose → examples |