A next-generation framework documentation provider for Claude Code via Model Context Protocol (MCP). Provides query-focused API context by extracting TypeScript definitions directly from npm packages - delivering minimal, accurate information instead of dumping entire documentation pages. mcp-name: dev.augments/mcp Version 4.0 introduces a fundamentally new approach to framework documentation: Doc
Add this skill
npx mdskills install augmnt/augments-mcp-serverNovel TypeScript-driven API documentation server with exceptional architecture and comprehensive tooling
123A next-generation framework documentation provider for Claude Code via Model Context Protocol (MCP). Provides **query-focused API context** by extracting TypeScript definitions directly from npm packages - delivering minimal, accurate information instead of dumping entire documentation pages.45mcp-name: dev.augments/mcp67## What's New in v489**Version 4.0** introduces a fundamentally new approach to framework documentation:1011| Old Approach (v3) | New Approach (v4) |12|-------------------|-------------------|13| Fetch entire documentation pages | Extract specific API signatures |14| ~50KB of context per query | ~500 tokens of precise context |15| Manual framework registry (85) | Auto-discovery via npm (millions) |16| No version support | Version-specific queries |17| Prose documentation | TypeScript definitions (source of truth) |1819### Why TypeScript Definitions?2021Documentation can be outdated or wrong. **TypeScript definitions can't lie** - they're compiled and must match the actual API. When you ask "what are the params for useEffect?", v4 gives you:2223```typescript24function useEffect(effect: EffectCallback, deps?: DependencyList): void25```2627Not 5KB of tutorial explaining what effects are.2829## Quick Start3031### Option 1: Hosted MCP Server (Recommended)3233```bash34# Add the hosted MCP server35claude mcp add --transport http augments https://mcp.augments.dev/mcp3637# Verify configuration38claude mcp list39```4041### Option 2: Using Cursor4243```json44{45 "mcpServers": {46 "augments": {47 "transport": "http",48 "url": "https://mcp.augments.dev/mcp"49 }50 }51}52```5354### Using the v4 Tools5556```57# Get API signature with minimal context58@augments get_api_context query="useEffect cleanup" framework="react" version="19"5960# Search for APIs across frameworks61@augments search_apis query="state management hook"6263# Get version information64@augments get_version_info framework="react" fromVersion="18" toVersion="19"65```6667## MCP Tools6869### v4 API Context Tools (New)7071| Tool | Description |72|------|-------------|73| `get_api_context` | Query-focused TypeScript extraction - returns minimal API signatures |74| `search_apis` | Search for APIs across frameworks by keyword |75| `get_version_info` | Get npm version info, compare versions, detect breaking changes |7677### Framework Discovery7879| Tool | Description |80|------|-------------|81| `list_available_frameworks` | List frameworks by category |82| `search_frameworks` | Search with relevance scoring |83| `get_framework_info` | Get detailed framework config |84| `get_registry_stats` | Registry statistics |8586### Documentation Access8788| Tool | Description |89|------|-------------|90| `get_framework_docs` | Fetch comprehensive documentation |91| `get_framework_examples` | Get code examples |92| `search_documentation` | Search within docs |9394### Context Enhancement9596| Tool | Description |97|------|-------------|98| `get_framework_context` | Multi-framework context |99| `analyze_code_compatibility` | Code compatibility check |100101### Cache Management102103| Tool | Description |104|------|-------------|105| `check_framework_updates` | Check for updates |106| `refresh_framework_cache` | Refresh cache |107| `get_cache_stats` | Cache statistics |108109## v4 Architecture110111```112┌─────────────────────────────────────────────────────────┐113│ Query: "useEffect cleanup react 19" │114└─────────────────────┬───────────────────────────────────┘115 ↓116┌─────────────────────────────────────────────────────────┐117│ Query Parser │118│ • Identify framework: react │119│ • Identify concept: useEffect │120│ • Identify version: 19 │121└─────────────────────┬───────────────────────────────────┘122 ↓123┌─────────────────────────────────────────────────────────┐124│ Type Fetcher │125│ • Fetch @types/react@19 from npm CDN │126│ • Handle barrel exports (sub-module fetching) │127│ • Cache with TTL │128└─────────────────────┬───────────────────────────────────┘129 ↓130┌─────────────────────────────────────────────────────────┐131│ Type Parser (TypeScript Compiler API) │132│ • Extract useEffect signature │133│ • Resolve related types (EffectCallback, etc.) │134│ • Find overloads │135└─────────────────────┬───────────────────────────────────┘136 ↓137┌─────────────────────────────────────────────────────────┐138│ Return ~500 tokens: │139│ { │140│ api: { name, signature, parameters, returnType }, │141│ relatedTypes: { EffectCallback: "...", ... }, │142│ examples: [...], │143│ version: "19.0.4" │144│ } │145└─────────────────────────────────────────────────────────┘146```147148### Source Structure149150```151src/152├── core/ # v4 Core modules153│ ├── query-parser.ts # Parse natural language → framework + concept154│ ├── type-fetcher.ts # Fetch .d.ts from npm/unpkg/jsdelivr155│ ├── type-parser.ts # Parse TypeScript, extract signatures156│ ├── example-extractor.ts # Fetch code examples from GitHub157│ └── version-registry.ts # npm registry integration158├── tools/159│ ├── v4/ # v4 API context tools160│ │ ├── get-api-context.ts161│ │ ├── search-apis.ts162│ │ └── get-version-info.ts163│ ├── discovery.ts # Framework discovery tools164│ ├── documentation.ts # Documentation tools165│ ├── context.ts # Context enhancement tools166│ └── cache-management.ts # Cache management167├── registry/ # Framework registry (v3 compatibility)168├── providers/ # Documentation providers169├── cache/ # Caching layer170└── server.ts # MCP server setup (15 tools)171```172173## Supported Frameworks174175### v4 Auto-Discovery176Any npm package with TypeScript types can be queried - no manual configuration needed:177- Bundled types (`"types": "./dist/index.d.ts"` in package.json)178- DefinitelyTyped (`@types/package-name`)179180### Tested & Optimized181| Framework | Package | Features |182|-----------|---------|----------|183| React | `react`, `@types/react` | All hooks, components, types |184| TanStack Query | `@tanstack/react-query` | useQuery, useMutation, etc. |185| React Hook Form | `react-hook-form` | useForm, useController, etc. |186| Supabase | `@supabase/supabase-js` | createClient, auth, storage |187| Express | `express` | Router, middleware |188| Mongoose | `mongoose` | Schema, Model |189| Next.js | `next` | App Router, Server Components |190| Vue 3 | `vue` | Composition API |191| Zod | `zod` | Schema validation |192| tRPC | `@trpc/client` | Type-safe APIs |193| Prisma | `@prisma/client` | Database ORM |194195### Legacy Framework Registry19685+ frameworks with manual documentation sources are still available via v3 tools.197198## Self-Hosting199200### Deploy to Vercel201202[](https://vercel.com/new/clone?repository-url=https://github.com/augmnt/augments-mcp-server&env=GITHUB_TOKEN,UPSTASH_REDIS_REST_URL,UPSTASH_REDIS_REST_TOKEN)203204### Environment Variables205206| Variable | Required | Description |207|----------|----------|-------------|208| `GITHUB_TOKEN` | Optional | GitHub token for higher API rate limits |209| `UPSTASH_REDIS_REST_URL` | Optional | Upstash Redis URL for caching |210| `UPSTASH_REDIS_REST_TOKEN` | Optional | Upstash Redis token |211212### Local Development213214```bash215# Clone and install216git clone https://github.com/augmnt/augments-mcp-server.git217cd augments-mcp-server218npm install219220# Run development server221npm run dev222223# Build224npm run build225226# Type check227npm run type-check228```229230## How v4 Compares to Context7231232| Aspect | Context7 | Augments v4 |233|--------|----------|-------------|234| **Source** | Parsed prose docs | TypeScript definitions |235| **Accuracy** | Docs can be wrong | Types must be correct |236| **Context size** | ~5-10KB chunks | ~500 tokens |237| **LLM cost** | Pays for ranking | Zero - pure data retrieval |238| **Freshness** | Crawl schedule | On-demand from npm |239| **Coverage** | Manual submission | Any npm package with types |240241## Contributing2422431. Fork the repository2442. Create a feature branch: `git checkout -b feature/amazing-feature`2453. Make your changes2464. Run tests and linting2475. Submit a pull request248249## License250251MIT License - see [LICENSE](LICENSE) for details.252253## Support254255- [GitHub Issues](https://github.com/augmnt/augments-mcp-server/issues)256- [GitHub Discussions](https://github.com/augmnt/augments-mcp-server/discussions)257258---259260**Built for the Claude Code ecosystem** | **Version 4.0.0**261
Full transparency — inspect the skill content before installing.