# mcp

Feeds type signatures, prose docs and code examples for any npm package into the agent conversation. Useful when you would rather not open a browser tab.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 127
- Author: augmnt
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/augmnt/augments-mcp-server
- Updated: 2026-03-13
- HTML: https://affpapa.org/en/nevibecode/mcp/augmnt-mcp

## What it does

The server answers the agent's questions about any npm package and hands back types, written explanations and snippets. Its documentation search runs on a BM25 index, so a natural-language question about middleware setup lands on the right heading instead of an empty result. Synonym clusters widen the match: a state-related word also picks up `useState`, `createStore` and similar names.

The primary tool is `get_api_context`. Next to it sit `search_apis` for keyword or concept lookup, `get_version_info` for comparing releases, `get_migration_guide` for moving between versions, `diagnose_error` for reading an error message, `compare_packages` for putting up to five packages side by side and `scan_project_deps` for checking `package.json` against outdated or vulnerable entries. A separate `diagnostics` tool reports server health.

Setting `GITHUB_TOKEN` raises the GitHub API ceiling while examples and docs are being fetched. Without it the server still runs, it just hits rate limits sooner. The only environment requirements are the ones implied by the install routes: a remote URL or a local start through `uvx`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://mcp.augments.dev/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.augments.dev/mcp
```

2. **Platform CLI**
```bash
claude mcp add augmnt-mcp -- uvx augments-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from augments-mcp-server <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add augmnt-mcp --url https://mcp.augments.dev/mcp
```

2. **Platform CLI**
```bash
codex mcp add augmnt-mcp -- uvx augments-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from augments-mcp-server <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "augmnt-mcp": {
            "url": "https://mcp.augments.dev/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "augmnt-mcp": {
            "command": "uvx",
            "args": [
                "augments-mcp-server"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from augments-mcp-server <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "augmnt-mcp": {
            "type": "http",
            "url": "https://mcp.augments.dev/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "augmnt-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "augments-mcp-server"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from augments-mcp-server <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http augmnt-mcp https://mcp.augments.dev/mcp
```

2. **Platform CLI**
```bash
gemini mcp add augmnt-mcp uvx augments-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from augments-mcp-server <command>

## When to use it
- look up a function signature in an unfamiliar npm package
- get a code example from a plain-language description
- spot what broke between two library versions
- trace the cause of a React error message
- audit package.json for stale dependencies

## Example prompts
- Show me a React example of cleaning up inside an effect
- Build a migration guide for next from 14 to 15
- Compare zod, yup and joi on bundle size and dependencies

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12109
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2760
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1348
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md