augments-mcp-server

Overview

Augments MCP Server is a sophisticated tool for framework documentation access via Model Context Protocol. It provides 8 powerful tools including documentation-first BM25 search, version comparison, error diagnosis, and dependency scanning. The server supports any npm package out of the box through multi-source integration including TypeScript types, GitHub documentation, and README content. Its intent-aware formatting adjusts response structure based on query type (howto, reference, migration), making it highly adaptable for different user needs. The architecture includes reliability features like exponential backoff, circuit breakers, and LRU caches.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_api_context

  Returns API signatures, prose documentation, and code examples for any npm package.

  Try:Get API context for useEffect cleanup in ReactTry:How to use Zustand middlewareTry:Show me Next.js authentication patterns
• search_apis

  Search for APIs across frameworks by keyword or concept with synonym awareness.

  Try:Search for state management APIsTry:Find animation librariesTry:Show me data fetching patterns
• get_version_info

  Get npm version info, compare versions, and detect breaking changes.

  Try:Compare React versions 18 and 19Try:Show breaking changes in Next.js 14Try:What's new in Prisma 5
• get_migration_guide

  Cross-version migration guide with breaking changes and deprecations.

  Try:Migrate from React 17 to 18Try:How to upgrade Next.js 13 to 14Try:Guide to migrating from Express to Fastify
• diagnose_error

  Diagnose errors using curated patterns and GitHub Issues.

  Try:Diagnose error: 'Objects are not valid as a React child'Try:What does 'Cannot read properties of undefined' mean in Next.jsTry:Help with TypeScript error: 'Property does not exist'
• compare_packages

  Compare 2-5 npm packages by downloads, bundle size, and dependencies.

  Try:Compare Zod and Yup for validationTry:Show differences between TanStack Query and SWRTry:Compare Express and Fastify performance
• scan_project_deps

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

  Try:Check my project dependencies for issuesTry:Find deprecated packages in my projectTry:Show security vulnerabilities in my dependencies
• diagnostics

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

  Try:Show server diagnosticsTry:What's the server uptimeTry:Check cache statistics

Comparable tools

Installation

# Add the MCP server (runs locally via npx)
claude mcp add -s user augments -- npx -y @augmnt-sh/augments-mcp-server

# Verify configuration
claude mcp list

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

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

FAQ

Which packages does Augments support?

Augments supports any npm package (~2.5M packages) through automatic documentation discovery from sources like GitHub repositories, TypeScript types, and README files.

How does it handle different query types?

It uses intent-aware formatting that adjusts response structure based on query intent - 'howto' queries show examples first, 'reference' shows signatures first, and 'migration' shows prose first.

Compare augments-mcp-server with