grasp_ingestLABSCO SUMMARY
One analysis returns a session id, and everything after that answers against it.
Sessions persist for 7 days and survive restarts, which is what makes the long tail of tools cheap enough to actually use — you are not re-parsing the repository per question. The credential story is unusual for a surface this size: local-first LLM detection, with a deterministic fallback that needs no key at all.
What it is
A code architecture suite exposed over MCP as a large tool set plus 8 resources and 2 prompts, spanning structure analysis, refactoring guidance, security and compliance reporting, and a document knowledge graph.
What you get
- Structure: grasp_file_deps, grasp_dependents, grasp_cycles, grasp_architecture, grasp_hotspots, grasp_metrics, grasp_find_path
- Cleanup and quality: grasp_unused, grasp_similarity, grasp_stale, grasp_types, grasp_change_risk, grasp_coverage_gaps
- Guidance: grasp_explain, grasp_refactor, grasp_suggest, grasp_onboard
- Security and compliance: grasp_security, grasp_sbom in CycloneDX or SPDX, grasp_sarif for GitHub Code Scanning, grasp_license, grasp_pii_trace, grasp_reg_impact, grasp_env_vars
- Drift tracking: grasp_snapshot and grasp_diff_snapshots, returning STABLE, DEGRADED or CRITICAL
- A knowledge graph you can feed: grasp_ingest takes PDF, DOCX, XLSX, HTML, image OCR, audio, video and YouTube; grasp_kg_ask answers with citations
- 35 languages, and a browser app, IDE extensions and CLI over the same engine
Requirements
npx grasp-mcp-server, or npm install -g grasp-mcp-server. No credentials are needed — the LLM layer auto-detects a local Ollama before any cloud key and falls back to a deterministic engine that needs none. Setting GRASP_HTTP_MCP exposes the server over Streamable HTTP on port 7333 so a team can share one instance.
Setup effort
One command — npx -y grasp-mcp-server
USE CASES
01
Getting oriented in a repository you have never seen
Analyse it, then ask for a reading order and the layer structure.
02
Deciding whether a change is risky
Score the changed files and look at what depends on them.
03
Feeding a security review into GitHub
Run the scan and export SARIF for Code Scanning, plus an SBOM.
04
Asking questions over documents, not just code
Ingest the PDFs and specs, then query them with citations back to the source.
150 tools
Listed in project docs. Your client may show a different list.
grasp_kg_askgrasp_kg_tracegrasp_kg_explaingrasp_kg_statsgrasp_kg_exportgrasp_llm_statusgrasp_snapshotgrasp_diff_snapshotsgrasp_coverage_gapsgrasp_org_summarygrasp_analyzegrasp_sessionsgrasp_diffgrasp_watchgrasp_rules_checkgrasp_config_checkgrasp_file_depsgrasp_dependentsgrasp_cyclesgrasp_architecturegrasp_hotspotsgrasp_metricsgrasp_find_pathgrasp_patternsgrasp_unusedgrasp_explaingrasp_refactorgrasp_suggestgrasp_onboardgrasp_typesgrasp_similaritygrasp_stalegrasp_change_riskgrasp_securitygrasp_sbomgrasp_sarifgrasp_licensegrasp_pii_tracegrasp_dutiesgrasp_reg_impactgrasp_env_varsgrasp_feature_flagsgrasp_pr_commentgrasp_pr_reviewgrasp_commitsgrasp_ci_statusgrasp_doragrasp_adrgrasp_embedgrasp_timelinegrasp_contributorsgrasp_coveragegrasp_issuesgrasp_jira_issuesgrasp_service_graphgrasp_deps_devgrasp_brain_indexgrasp_brain_statusgrasp_contextgrasp_arch_diffgrasp_askgraph_querycall_chaintype_propagationfunction_graphgrasp_dead_packagesgrasp_runtime_callsgrasp_db_couplinggrasp_migration_plangrasp_api_surfacegrasp_eventsgrasp_perfgrasp_bundlegrasp_dep_impactgrasp_cross_repograsp_diagramgrasp_req_tracegrasp_anomalygrasp_reusegrasp_safety_tracegrasp_multilanggrasp_heritagegrasp_icdgrasp_ecssgrasp_run_diffgrasp_eval_coveragegrasp_org_graphgrasp_api_diffgrasp_pluginsgrasp_semvergrasp_abi_diffgrasp_subsystemsgrasp_kconfiggrasp_irqgrasp_patch_impactgrasp_good_first_issuesgrasp_api_stabilitygrasp_fork_diffgrasp_latencygrasp_model_riskgrasp_diff_symbolsgrasp_exec_flowgrasp_skillmdgrasp_hooksgrasp_mrograsp_communitiesgrasp_contractsgrasp_confidencegrasp_wikigrasp_registry_listgrasp_registry_statusgrasp_resolve_receivergrasp_searchgrasp_renamegrasp_route_mapgrasp_api_impactgrasp_tool_mapgrasp_shape_checkgrasp_group_addgrasp_group_listgrasp_graph_schemagrasp_type_propagationgrasp_orm_mapgrasp_detect_changesgrasp_generate_agents_mdgrasp_generate_skillsgrasp_hub_nodesgrasp_bridge_nodesgrasp_surprising_connectionsgrasp_knowledge_gapsgrasp_suggested_questionsgrasp_minimal_contextgrasp_traversegrasp_semantic_searchgrasp_apply_refactorgrasp_architecture_overviewgrasp_export_graphmlgrasp_export_cyphergrasp_export_obsidiangrasp_export_dotgrasp_export_mermaidgrasp_export_d2grasp_export_plantumlgrasp_export_dgmlgrasp_export_gexfgrasp_export_drawiograsp_export_csvgrasp_vulnerabilitiesgrasp_vuln_watchBEFORE YOU INSTALL
What to know first
Tools you get
150 tools named in the project's documentation.
Requires
npx on PATH
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y grasp-mcp-serverMCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add grasp -- npx -y grasp-mcp-serverCursor
CURSOR · JSON
{
"mcpServers": {
"grasp": {
"command": "npx",
"args": [
"grasp-mcp-server"
]
}
}
}
