
How to add Augments MCP Server to Cursor
Real-time framework docs (types + prose + examples) for any npm package via MCP. Paste the config into ~/.cursor/mcp.json and restart Cursor.
Last updated June 14, 2026 · 124★ · stdio · no auth
Cursor 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
- 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
- 2Paste the Augments MCP Server config below into the "mcpServers" object.
- 3Fill in placeholder secrets, then save.
- 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
- 5Ask Cursor to use one of Augments MCP Server's tools to confirm it's connected.
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 Cursor
get_api_contextPrimary 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_apisSearch for APIs across frameworks by keyword or concept. 25 synonym clusters (e.g. "state" matches useState, createStore, atom, etc).
get_version_infoGet npm version info, compare versions, and detect breaking changes backed by real changelogs.
get_migration_guideCross-version migration guide with breaking changes, new features, deprecations, type diffs, and official migration docs.
diagnose_errorDiagnose errors using curated patterns, GitHub Issues search, and troubleshooting docs.
compare_packagesCompare 2-5 npm packages: downloads, bundle size, GitHub stars, dependencies, exported APIs.
scan_project_depsScan package.json for outdated, deprecated, and insecure dependencies.
diagnosticsServer 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 + Cursor FAQ
Where is the Cursor config file?
Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Augments MCP Server config there under the "mcpServers" key and restart the client.
Is Augments MCP Server safe to use with Cursor?
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.