Augments MCP Server

Real-time framework docs (types + prose + examples) for any npm package via MCP.

Unverified

stdio (local)

No auth

TypeScript

View repo 124 Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

claude mcp add -s user augments -- npx -y @augmnt-sh/augments-mcp-server

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "augments-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@augmnt-sh/augments-mcp-server"
      ],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

Node.js (npx available)
Optional: a GITHUB_TOKEN (GitHub personal access token) for higher GitHub API rate limits

About Augments MCP Server

A next-generation framework documentation provider for Claude Code via MCP. Augments returns types, prose documentation, and code examples for any npm package, with context-aware (intent-driven) formatting. Documentation is resolved on-demand from npm and GitHub through documentation search (BM25-indexed), TypeScript types, auto-discovered docs, and README fallback. v7 exposes 8 tools spanning API context retrieval, concept-aware search, version/migration info, error diagnosis, package comparison, and dependency scanning.

Tools & capabilities (8)

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 (e.g. "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

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

diagnose_error

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

compare_packages

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

scan_project_deps

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

diagnostics

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

When to use it

Get API context (signatures, prose, examples) for any npm package while coding in Claude Code or Cursor
Search for APIs by concept using synonym-aware, BM25-indexed documentation search
Compare versions and get cross-version migration guides with breaking changes and type diffs
Diagnose runtime errors against curated patterns and GitHub Issues
Compare candidate packages side-by-side (downloads, bundle size, stars, dependencies)
Scan a project's package.json for outdated, deprecated, or insecure dependencies

Security notes

Runs locally via npx. No authentication required. Optionally set the GITHUB_TOKEN environment variable to a GitHub personal access token for higher GitHub API rate limits when fetching examples and documentation.

Augments MCP Server FAQ

Which npm packages are supported?

Every npm package is supported out of the box (~2.5M packages) with no curation or configuration. Augments resolves docs automatically via documentation search, TypeScript types, auto-discovered docs, and README fallback. 22 popular frameworks additionally have curated doc sources for richer examples.

Do I need an API key or token?

No. The server runs locally via npx and requires no authentication. You can optionally set the GITHUB_TOKEN environment variable to a GitHub personal access token to get higher GitHub API rate limits when fetching examples and documentation.

How is it different from Context7?

Augments combines TypeScript types with BM25-indexed docs and README content (types must be correct, docs supplement), returns smaller intent-aware context (~500-2000 tokens), supports any npm package via auto-discovery, and adds migration guides, error diagnosis, and dependency scanning.

How do I add it to Claude Code?

Run: claude mcp add -s user augments -- npx -y @augmnt-sh/augments-mcp-server, then verify with claude mcp list.

#documentation #npm #typescript #claude-code #framework-docs #bm25-search #developer-tools

Alternatives to Augments MCP Server

Compare all alternatives →

Playwright MCP Server

Developer Tools

24k

Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).

Featured

Verified

stdio (local)

No auth

TypeScript

12 tools

Updated 13 days agoRepo

Context7 MCP Server

Developer Tools

28k

Up-to-date, version-specific library documentation injected into your coding agent.

Verified

stdio (local)

API key

TypeScript

2 tools

Updated 17 days agoRepo

Serena

Developer Tools

12k

LSP-powered coding agent toolkit: semantic symbol search, references and structural edits.

Verified

stdio (local)

No auth

Python

11 tools

Updated 15 days agoRepo

Compare Augments MCP Server with:

vs Playwright MCP Server vs Context7 MCP Server vs Serena vs Mobile MCP