MCP Directory

How to add Augments MCP Server to Windsurf

Real-time framework docs (types + prose + examples) for any npm package via MCP. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 124★ · stdio · no auth

Windsurf config for Augments MCP Server

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

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Augments MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Augments MCP Server's tools become available to Cascade.

Before you start

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

What Augments MCP Server can do in Windsurf

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.

Security

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Augments MCP Server config there under the "mcpServers" key and restart the client.

Is Augments MCP Server safe to use with Windsurf?

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.

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.

View repo Full Augments MCP Server page