augmnt avatar

Augments Mcp Server

augmnt/augments-mcp-server

Brings framework documentation directly into Claude Code by combining TypeScript definitions, GitHub docs, and real code examples for any npm package. Eight tools handle natural language queries like "useEffect cleanup" or "zustand middleware", returning formatted API context with BM25 search across actual documentation. Also surfaces breaking changes between versions backed by real changelogs, diagnoses errors against curated patterns and GitHub issues, compares packages side by side, and scans dependencies for outdated or insecure versions. Runs locally via npx with optional GitHub token for higher rate limits. Reach for this when you need context aware framework references without leaving your editor, especially for migration planning or debugging unfamiliar APIs.

GitHub stars
124
tools
8
transport
STDIO
last updated
Sep 12, 2025

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

get_api_contextPrimary tool. Returns API signatures, prose documentation, and code examples for any npm package. Handles natural language queries with intent detection.

Primary tool. Returns API signatures, prose documentation, and code examples for any npm package. Handles natural language queries with intent detection.

No parameter schema in public metadata yet.

search_apisSearch for APIs across frameworks by keyword or concept.

Search for APIs across frameworks by keyword or concept.

No parameter schema in public metadata yet.

get_version_infoGet npm version info, compare versions, and detect breaking changes backed by real changelogs.

Get npm version info, compare versions, and detect breaking changes backed by real changelogs.

No parameter schema in public metadata yet.

get_migration_guideCross-version migration guide with breaking changes, new features, deprecations, type diffs, and official migration docs.

Cross-version migration guide with breaking changes, new features, deprecations, type diffs, and official migration docs.

No parameter schema in public metadata yet.

diagnose_errorDiagnose errors using curated patterns, GitHub Issues search, and troubleshooting docs.

Diagnose errors using curated patterns, GitHub Issues search, and troubleshooting docs.

No parameter schema in public metadata yet.

compare_packagesCompare 2-5 npm packages: downloads, bundle size, GitHub stars, dependencies, exported APIs.

Compare 2-5 npm packages: downloads, bundle size, GitHub stars, dependencies, exported APIs.

No parameter schema in public metadata yet.

scan_project_depsScan package.json for outdated, deprecated, and insecure dependencies.

Scan package.json for outdated, deprecated, and insecure dependencies.

No parameter schema in public metadata yet.

diagnosticsServer health: version, uptime, memory, cache stats, Node.js version.

Server health: version, uptime, memory, cache stats, Node.js version.

No parameter schema in public metadata yet.

Sponsors

Readme

Augments MCP Server

A next-generation framework documentation provider for Claude Code via Model Context Protocol (MCP). Returns types + prose + examples with context-aware formatting for any npm package — not just curated ones.

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.

v6v7
3 tools8 tools (+ diagnostics)
Types-only searchDocumentation-first BM25 search
8 concept synonyms25 concept synonym clusters
Generic version diffsReal changelog-backed breaking changes
No migration guidesCross-version migration guides
No error diagnosisCurated error patterns + GitHub Issues
No package comparisonSide-by-side package comparison
No dep scanningDependency scanner (outdated/deprecated/security)
FIFO cachesLRU caches with hit/miss stats
Fixed retry delaysExponential backoff + circuit breaker

Quick Start

Claude Code


View the full README on GitHub

Details

Repository
github.com/augmnt/augments-mcp-server
Package
augments-mcp-server
Transport
STDIO
Registry
MCP registry, active