augmnt/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 v5

Version 5.0 closes the gap with context7 by adding prose documentation, README fallback, concept search, and intent-aware formatting — while keeping the type-signature accuracy that made v4 unique.

What You Get Now

Query: "how to use zustand"
→ Intent: howto
→ Code examples first, then prose explanation, then brief signature

Query: "useEffect signature"
→ Intent: reference
→ Full signature, parameters, return type, related types, 1 example

Query: "ioredis set"
→ README fallback provides examples for uncurated packages

Quick Start

Option 1: Hosted MCP Server — project-local (Recommended)

# Add the hosted MCP server (available in current project only)
claude mcp add --transport http augments https://mcp.augments.dev/mcp

# Verify configuration
claude mcp list

Option 2: Hosted MCP Server — user-wide

# Add the hosted MCP server (available across all projects)
claude mcp add --transport http --scope user augments https://mcp.augments.dev/mcp

# Verify configuration
claude mcp list

Option 3: Using Cursor

{
  "mcpServers": {
    "augments": {
      "transport": "http",
      "url": "https://mcp.augments.dev/mcp"
    }
  }
}

Usage

# Get API context with prose + examples (recommended first tool to try)
@augments get_api_context query="useEffect cleanup" framework="react"

# How-to format — examples first
@augments get_api_context query="how to use zustand"

# Reference format — full signature first
@augments get_api_context query="zod object signature"

# Search for APIs by concept (synonym-aware)
@augments search_apis query="state management"

# Get version information and breaking changes
@augments get_version_info framework="react" fromVersion="18" toVersion="19"

Tools

Architecture

flowchart TD
    A["Query: 'how to use useEffect cleanup'"] --> B

    B["Intent Detection → howto<br/>Query Parser → react / useEffect"]

    B --> C["Type Fetcher<br/>CDN racing · npm metadata · @types"]
    B --> D["Example Extractor<br/>GitHub docs · README fallback · Auto-discovery"]

    C --> E["Type Parser<br/>Signatures · Parameters · Related types"]
    D --> F["Prose Extractor<br/>Section scoring · Paragraph extract · 2000 char budget"]

    E --> G["Intent-Driven Formatter (howto)<br/>→ Examples first, prose, brief signature<br/>→ ~500-2000 tokens, 10KB max"]
    F --> G

Source Structure

src/
├── core/                    # Core modules
│   ├── query-parser.ts      # Parse natural language → framework + concept
│   ├── type-fetcher.ts      # Fetch .d.ts + README from npm/unpkg/jsdelivr
│   ├── type-parser.ts       # Parse TypeScript, extract signatures, synonym search
│   ├── example-extractor.ts # Fetch examples from GitHub docs + auto-discovery
│   └── version-registry.ts  # npm registry integration
├── tools/v4/                # MCP tools
│   ├── get-api-context.ts   # Primary tool (types + prose + examples)
│   ├── search-apis.ts       # Cross-framework API search
│   └── get-version-info.ts  # Version comparison
└── server.ts                # MCP server (3 tools)

Key Features

Concept Synonyms

"state management" matches useState, useReducer, createStore, atom, signal, ref, reactive, writable, store. Eight concept clusters cover state, form, fetch, animation, routing, auth, cache, and effect patterns.

README Fallback

For the 99%+ of npm packages without curated documentation sources, augments fetches README.md from the CDN and extracts concept-relevant code blocks and prose.

Auto-Discovery

When no curated doc source exists, augments parses the npm repository field, identifies the GitHub repo, and probes for docs/, documentation/, doc/, or README.md.

Intent-Aware Formatting

Coverage

Any npm Package

Every npm package is supported out of the box — no curation or configuration needed. Augments resolves documentation automatically through three layers:

1. TypeScript types — bundled ("types" in package.json) or DefinitelyTyped (@types/*)
2. Auto-discovered docs — parses the npm repository field, finds the GitHub repo, and probes docs/, documentation/, doc/ directories
3. README fallback — extracts concept-relevant code blocks and prose directly from README.md

This means augments works with the entire npm ecosystem (~2.5M packages), not just a curated subset.

Enhanced Results for Popular Frameworks

22 frameworks have curated doc sources for richer examples: React, Next.js, Vue, Prisma, Zod, Supabase, TanStack Query, tRPC, React Hook Form, Framer Motion, Express, Zustand, Jotai, Drizzle, SWR, Vitest, Playwright, Fastify, Hono, Solid, Svelte, Angular, Redux

Barrel Export Handling

Special sub-module resolution for: React Hook Form, TanStack Query, Zustand, Jotai, tRPC, Drizzle ORM, Next.js

Self-Hosting

Deploy to Vercel

Local Development

# Clone and install
git clone https://github.com/augmnt/augments-mcp-server.git
cd augments-mcp-server
npm install

# Run development server
npm run dev

# Run tests
npm test

# Type check
npm run type-check

# Build
npm run build

How v5 Compares to Context7

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Run tests: npm test
5. Submit a pull request

License

MIT License - see for details.

Support

• GitHub Issues
• GitHub Discussions

Built for the Claude Code ecosystem | Version 5.0.0