Log inSubmit server
Augments MCP Server logo

Augments MCP Server

by augmnt

Fetches npm API documentation, examples, version changes, migration guidance, error diagnoses, and dependency reports through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Augments MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "augmnt-augments-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@augmnt-sh/augments-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 8 tools correctly (1mo ago).

Overview

The augmnt/augments-mcp-server MCP server supplies Claude Code and other MCP clients with current npm package documentation, type information, and code examples. Its tools search APIs, inspect versions and changelogs, generate migration guidance, diagnose errors, compare packages, scan package.json dependencies, and report server diagnostics. It retrieves information from npm, CDNs, GitHub documentation, package repositories, changelogs, and README files, then formats results according to query intent. Reach for it when an agent needs framework or package reference material without relying only on a static, curated documentation set.

Use cases

  • Look up current React or Next.js APIs with examples
  • Compare npm packages before choosing a dependency
  • Generate migration guidance between package versions
  • Diagnose JavaScript and TypeScript package errors
  • Scan package.json for outdated or insecure dependencies

Key features

  • Documentation-first BM25 API search
  • Type signatures, prose, and code examples
  • Changelog-backed version and migration analysis
  • GitHub issue-assisted error diagnosis
  • npm package comparison
  • Dependency and server health scanning

Tools8

What Augments MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~1.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 53d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @augmnt-sh/augments-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars127Stargazers on the source repository.
npm downloads131Package downloads in the last 30 days.
Last commit7mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed8Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Augments MCP Server works

What augmnt/augments-mcp-server MCP server does

The augmnt/augments-mcp-server MCP server gives an MCP-connected coding agent access to npm package documentation and related project metadata. It is designed for framework and library questions that need more than a package name or TypeScript signature: responses can include parameters, return types, explanatory prose, and implementation examples.

The server supports npm packages broadly rather than limiting lookups to a fixed catalog. It can use package metadata, bundled declaration files, DefinitelyTyped types, GitHub repositories, documentation directories, and README content.

How it works

Natural-language queries are parsed for package, framework, concept, and intent. Documentation is indexed with BM25 search and split into heading-based chunks; API names receive additional search weight, and synonym groups expand concepts such as state management, routing, validation, testing, and pagination. The response format changes based on whether the request asks for a how-to example, a reference signature, a migration, or a balanced result.

For API context, the server can race or consult npm metadata, CDNs, type sources, and documentation sources before combining the results. Version analysis uses npm registry data, declaration-file differences, changelogs, and GitHub releases. Error diagnosis combines curated error patterns with GitHub issue and documentation searches. Caches use an LRU strategy, while network handling includes retry backoff, CDN circuit breaking, and GitHub rate-limit tracking.

Setup and configuration

Install the augmnt/augments-mcp-server MCP server locally with npx:

Terminal
npx -y @augmnt-sh/augments-mcp-server

Claude Code can register that command as a user-scoped MCP server, and Cursor can use it as the command with -y and @augmnt-sh/augments-mcp-server in its MCP configuration. The documented package entry point uses stdio, so the client starts the process locally.

GITHUB_TOKEN is optional. Supplying it increases GitHub API rate limits when the server retrieves examples and documentation; the material does not identify any other required environment variable or credential.

Tools and capabilities

The augmnt/augments-mcp-server MCP server exposes these capabilities:

  • get_api_context retrieves signatures, parameters, return types, prose, and examples for natural-language or API-specific npm queries.
  • search_apis searches across frameworks using keyword and concept matching.
  • get_version_info reports available versions and changelog-backed breaking changes or new features.
  • get_migration_guide compares package versions and includes changes, deprecations, type differences, and official migration documentation when available.
  • diagnose_error analyzes error messages and stack traces against known patterns, GitHub issues, and documentation.
  • compare_packages compares two to five npm packages using downloads, bundle size, dependencies, GitHub stars, and exported APIs.
  • scan_project_deps reads package.json to identify outdated, deprecated, and security-affected dependencies.
  • diagnostics reports server version, uptime, memory, cache statistics, and Node.js version.

Limitations and notes

Results depend on the availability of public npm, CDN, GitHub, repository, changelog, and README data. GitHub access is subject to API rate limits; a token raises the available limit but is not documented as mandatory.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Augments MCP Server

Run `npx -y @augmnt-sh/augments-mcp-server` as a local stdio MCP process. Claude Code can register this command, and Cursor can add it to its MCP configuration.

Yes. The README provides a Cursor MCP configuration using `npx` with `-y` and `@augmnt-sh/augments-mcp-server`.

No token is documented as required. Setting `GITHUB_TOKEN` provides higher GitHub API rate limits for fetching examples and documentation.

Yes. `get_migration_guide` compares package versions and can return breaking changes, new features, deprecations, type differences, and official migration documentation.

Yes. `scan_project_deps` reads `package.json` and checks for outdated packages, major updates, deprecated packages, and security advisories.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAugments MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/augmnt-augments-mcp-server?style=directory)](https://allmcps.com/mcp/augmnt-augments-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/augmnt-augments-mcp-server"><img src="https://allmcps.com/api/badge/augmnt-augments-mcp-server?style=directory" alt="Augments MCP Server on AllMCPs" /></a>