{"report":{"v":1,"package":"@greenarmor/ges-mcp-server","version":"1.6.9","ranAt":"2026-11-16T11:57:33.697Z","install":{"ok":true,"integrity":"sha512-EbSogkrB9XbKSf+ZnoxYciV1RKyAUV2L/NxjPp/S8IukK7LKr8tqygi3DTGCaG28D1xklVBgGFYaDHVl08mDCQ==","deps":13,"scripts":[],"bins":["ges-mcp"],"license":"MIT","engines":"node >=20.0.0","repository":"git+https://github.com/greenarmor/gesf.git","bin":"ges-mcp"},"start":{"ok":true,"ms":141,"serverName":"gesf-mcp-server","serverVersion":"1.6.9","protocol":"2024-11-05"},"tools":[{"name":"check_compliance","description":"Check GDPR compliance status for a project. Returns compliance scores per framework (GDPR, OWASP, CIS, NIST) with grades and control breakdown.","params":["project_type"]},{"name":"check_project_status","description":"Read the actual project's .ges/ directory to get real-time compliance status, scores, config, and audit results. Use this when the project has already been initialized with 'ges init'.","params":["project_path"]},{"name":"list_missing_controls","description":"Show missing or failed compliance controls for a given framework. Returns control ID, severity, name, and implementation guidance.","params":["project_type","framework"]},{"name":"list_framework_controls","description":"List all controls for a given framework with their status, severity, category, and implementation guidance. Useful for understanding the full control landscape.","params":["framework","status_filter"]},{"name":"run_audit","description":"Run a full source code security audit on the project. Scans for secrets, weak cryptography, injection vulnerabilities, auth issues, config problems, and database anti-patterns. Returns findings with severity, file location, evidence, and fix guidance.","params":["project_path"]},{"name":"generate_compliance_report","description":"Generate a full compliance report with executive summary, findings, framework scores, risk assessment, security controls, and actionable recommendations. The primary report tool for compliance status.","params":["project_type","project_name","frameworks"]},{"name":"generate_audit_report","description":"Generate a report from actual source code audit findings. Combines audit results with compliance scoring and detailed recommendations for each finding. Requires a project path.","params":["project_path","project_name"]},{"name":"fix_recommendation","description":"Get detailed step-by-step remediation guidance for a specific control or finding. Provides implementation steps, code examples, and verification steps. Use this to fix issues one by one.","params":["control_id","finding_title"]},{"name":"generate_retention_policy","description":"Generate a data retention policy template","params":["project_name"]},{"name":"generate_incident_response","description":"Generate an incident response plan template","params":["project_name"]},{"name":"generate_risk_assessment","description":"Generate a risk assessment template","params":["project_name"]},{"name":"generate_dpa","description":"Generate a Data Processing Agreement template","params":["project_name"]},{"name":"generate_data_inventory","description":"Generate a data inventory document listing data categories, classifications, retention periods, and legal basis. Required for GDPR Article 30 compliance.","params":["project_name","project_type"]},{"name":"generate_processing_records","description":"Generate Article 30 Records of Processing Activities (ROPA). Documents all processing activities, purposes, data categories, recipients, and retention periods.","params":["project_name","controller_name"]},{"name":"auto_fix","description":"Run an audit and automatically fix all fixable security/compliance issues in the project source code. Creates files, modifies source, generates security scaffolding. Returns a detailed report of what was fixed and what requires manual review.","params":["project_path","dry_run","rule_ids"]},{"name":"apply_control_override","description":"Mark a compliance control as not-applicable. AI assistants CANNOT mark controls as 'pass' — that must be verified by the GESF audit engine (run_audit). Use 'not-applicable' only when a control genuinely does not apply to the project. A detailed reason is required.","params":["project_path","control_id","status","reason"]},{"name":"implement_control","description":"Generate and write actual implementation files for a compliance control into the target project. Creates source files, configuration, and middleware. Returns what was created and next steps.","params":["project_path","control_id"]},{"name":"generate_badge","description":"Generate an SVG compliance score badge for a project's README. Reads the project's .ges/score.json and produces a shields.io-style SVG badge with the compliance score and grade. Optionally injects into README.md.","params":["project_path","output","readme"]},{"name":"get_score","description":"Read and display the compliance score from a project's .ges/score.json. Shows per-framework scores, grades, and overall compliance percentage.","params":["project_path"]},{"name":"init_project","description":"Initialize GESF in a project directory. Creates the .ges/ directory structure, compliance/security documentation, controls, CI/CD workflows, and configuration files. Automatically installs the privacy pack for the specified country of origin.","params":["project_path","project_name","project_type","frameworks","country","additional_packs","force"]},{"name":"suggest_packs","description":"Analyze the project and recommend which privacy/compliance policy packs to install. Examines project type, country of origin, installed packs, codebase patterns (dependencies, file structure), and data processing indicators. Returns ranked recommendations with rationale. Does NOT install packs — use policy_install to act on suggestions.","params":["project_path","country","project_type"]},{"name":"run_scans","description":"Run security scanner integrations on a project. Detects the ecosystem (Node.js, Python, etc.) and runs available scanners (npm audit, Trivy, Gitleaks, Semgrep, etc.) plus SBOM generation.","params":["project_path"]},{"name":"doctor","description":"Diagnose GESF project health. Checks if the project is initialized, config files exist, score is available, required directories are present, and GitHub Actions are configured.","params":["project_path"]},{"name":"validate_project","description":"Validate GESF project configuration and controls. Checks config.json against the schema, validates control files, and verifies required directories exist.","params":["project_path"]},{"name":"policy_list","description":"List all available policy packs with their IDs, names, control counts, and supported project types.","params":[]},{"name":"policy_install","description":"Install a policy pack into a project. Writes the pack's controls as a JSON file in the controls/ directory.","params":["project_path","pack_id"]},{"name":"policy_remove","description":"Remove an installed policy pack from a project. Deletes the pack's directory from controls/.","params":["project_path","pack_id"]},{"name":"update_check","description":"Check the current GESF version and get update instructions.","params":[]},{"name":"install_hooks","description":"Install GESF git hooks (pre-commit) that run compliance checks before allowing commits. Also supports uninstalling hooks.","params":["project_path","action"]},{"name":"start_dashboard","description":"Get instructions and configuration for starting the GESF compliance web dashboard. The dashboard provides a browser-based view of compliance status, scores, and findings. Note: the actual server must be started via the CLI 'ges dashboard' command.","params":["project_path","port","host"]},{"name":"record_recommendation","description":"Record a recommendation or observation to .dev-logs/ai-recommendations/ for the GESF development team. Use this when you identify a potential improvement, weakness, or best-practice suggestion. Recommendations are NOT applied automatically — they are logged for human developers to review. This is the correct way to surface ideas instead of overriding controls.","params":["project_path","category","title","description","severity","affected_controls","affected_files","suggested_action"]},{"name":"create_governance_record","description":"Create a new governance provenance record for an AI system, application, data process, or model. Establishes the root of the approval provenance chain (System → Risk → Policy → Approval → Evidence → Review). The record starts in 'draft' status — use approve_governance_record to record an approval decision and add_governance_evidence to attach supporting evidence.","params":["project_path","system_name","system_type","system_description","system_version","risk_level","created_by","actor_name","actor_role"]},{"name":"approve_governance_record","description":"Record an approval decision on a governance record. Captures who approved the system, under what authority, when, the validity period, and any conditions. This is a critical link in the provenance chain — it answers 'Who approved this AI system? Under which authority? When? Is it still valid?'","params":["project_path","record_id","approver_name","approver_role","approver_email","approval_authority","decision","valid_from","valid_until","conditions","rationale","actor_name","actor_role"]},{"name":"add_governance_evidence","description":"Add an evidence reference to a governance record. Evidence references point to supporting documentation in external systems (Jira, Confluence, ServiceNow, SharePoint, GRC platforms, etc.) WITHOUT duplicating their content. This maintains a single source of truth while providing a unified governance view. Each evidence entry answers 'What evidence exists to support the decision?'","params":["project_path","record_id","title","type","source_system","reference","location_description","added_by","actor_name","actor_role"]},{"name":"list_governance_records","description":"List all governance provenance records in a project. Returns a summary of each record including system name, status, risk level, approval status, and evidence count. Use this to see all governed systems and their current compliance state.","params":["project_path"]},{"name":"get_governance_record","description":"Get the full provenance chain for a single governance record. Returns all linked dimensions: system identity, risk assessment, policy basis, approval decision, committee approval, evidence chain, review cycle, data inventory, and compliance links. This provides the complete 'single defensible answer' for auditors — the full chain from AI System → Risk Assessment → Policy → Approval → Evidence → Review Cycle.","params":["project_path","record_id"]},{"name":"verify_governance_record","description":"Verify the provenance chain completeness of a governance record. Checks all dimensions: approval exists and is not expired, risk assessment present, evidence attached, review cycle defined, data inventory complete. Returns a verification result with completeness checklist, blocking issues, warnings, and approval expiry status. This is the 'single defensible answer' function for auditors.","params":["project_path","record_id"]},{"name":"set_governance_risk_assessment","description":"Link a risk assessment to a governance record. Captures assessor, methodology, risk score, identified risks, residual risk, and mitigation measures. This is a required dimension for provenance chain completeness — without it, verification will report a blocking issue.","params":["project_path","record_id","assessor","methodology","risk_score","residual_risk","identified_risks","mitigation_measures","actor_name","actor_role"]},{"name":"set_governance_policy_basis","description":"Document the policy or standard under which a system is approved. Captures policy ID, name, version, applicable clauses, and the standard reference. This provides the regulatory basis for the approval decision.","params":["project_path","record_id","policy_id","policy_name","version","standard","clauses","actor_name","actor_role"]},{"name":"set_governance_review_cycle","description":"Set up a periodic review cycle for a governance record. Defines how often the approval must be re-reviewed and when the next review is due. Enables continuous compliance monitoring.","params":["project_path","record_id","frequency","next_review","actor_name","actor_role"]},{"name":"set_governance_data_inventory","description":"Document the data inventory for a governance record. Captures personal data categories, processing purposes, data subjects, cross-border transfers, and retention period.","params":["project_path","record_id","personal_data_categories","processing_purposes","data_subjects","cross_border_transfers","retention_period","actor_name","actor_role"]},{"name":"set_governance_committee","description":"Record committee approval details for a governance record. Captures committee name, meeting date, meeting reference, attendees, and decision summary.","params":["project_path","record_id","committee_name","meeting_date","meeting_reference","attendees","decision_summary","actor_name","actor_role"]},{"name":"set_governance_compliance_links","description":"Map compliance frameworks and controls to a governance record. Links the record to GDPR, OWASP, CIS, NIST, etc., and references which controls are satisfied by this system's governance.","params":["project_path","record_id","frameworks","controls_satisfied","control_pack_ids","actor_name","actor_role"]},{"name":"assign_fix_to_governance","description":"Assign a pending audit finding (fix) to an existing governance provenance record. Creates a traceable link between a specific security finding and the governance chain (who approved the system, under what policy, what risk assessment supports it). Requires a finding_key (ruleId:file:line), governance record ID, and assignee name.","params":["project_path","finding_key","finding_rule_id","finding_title","finding_file","finding_line","finding_severity","finding_control_ids","governance_record_id","assignee","assignee_role","notes","actor_name","actor_role"]},{"name":"list_fix_assignments","description":"List all fix assignments linking pending audit findings to governance provenance records. Shows which fixes are assigned, to whom, linked to which governance record, and their status (assigned, in-progress, fixed, verified).","params":["project_path","governance_record_id"]},{"name":"resolve_fix_assignment","description":"Resolve (mark as fixed) a fix assignment that was linked to a governance record. Records who resolved it, the method used (auto-fix, manual, not-applicable), and resolution notes. Updates the provenance chain to show the fix has been addressed.","params":["project_path","finding_key","resolved_by","resolved_by_role","method","resolution_notes","actor_name","actor_role"]},{"name":"run_inference","description":"Run AI-powered inference on GESF compliance data. Analyzes audit findings (clustering + deduplication), identifies root causes via graph analysis, detects score anomalies, and predicts compliance trends. Returns a comprehensive InferenceReport with actionable insights.","params":["project_path"]}],"toolsHash":"47de52b3eb184b49ee1aec05daccbd09d180091ca10b559575912168d14e13ef","wrote":[],"callsAt":"2026-11-16T11:57:40.138Z","calls":[{"tool":"check_project_status","ok":true,"ms":2,"bytes":75},{"tool":"list_missing_controls","ok":true,"ms":6,"bytes":8274},{"tool":"list_framework_controls","ok":true,"ms":0,"bytes":2106},{"tool":"get_score","ok":true,"ms":1,"bytes":75},{"tool":"policy_list","ok":true,"ms":1,"bytes":4874}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":47,"wrote":0,"callsTried":5,"callsAnswered":5,"callContacts":[]},"history":[{"package":"@greenarmor/ges-mcp-server","version":"1.6.9","ranAt":"2026-11-16T11:57:33.697Z","outcome":"started","tools":47,"contacts":0,"flags":0,"serious":0,"toolsHash":"47de52b3eb184b49ee1aec05daccbd09d180091ca10b559575912168d14e13ef"}],"page":"https://bragproof.smaverk.com/r/%40greenarmor/ges-mcp-server"}