ATOMSATOMSDocs
Tool Reference

atoms_project_summary

One-call project health and compliance dashboard

Retrieve a comprehensive health and compliance dashboard for an entire project in a single call. Returns item counts, test status breakdowns, coverage metrics, and recent changes. In capable MCP hosts, this tool renders an interactive MCP App with charts and gauges for visual project oversight.

Parameters

ParameterTypeRequiredDescription
project_idstring (UUID)YesThe project to summarize

Example Response

{
  "status": "success",
  "data": {
    "project_name": "Drive Pilot v2",
    "counts": {
      "requirement": 48,
      "test-case": 35,
      "note": 12
    },
    "test_status": {
      "passed": 22,
      "failed": 5,
      "blocked": 3,
      "not-run": 5
    },
    "coverage": {
      "covered": 38,
      "uncovered": 10,
      "total": 48,
      "coverage_percent": 79.2,
      "uncovered_items": ["REQ-009", "REQ-014", "REQ-027"]
    },
    "coverage_by_domain": {
      "safety": { "covered": 12, "total": 14, "percent": 85.7 },
      "security": { "covered": 8, "total": 10, "percent": 80.0 },
      "performance": { "covered": 5, "total": 8, "percent": 62.5 }
    },
    "recent_changes": [
      {
        "item_id": "REQ-048",
        "event_type": "created",
        "changed_at": "2025-04-12T16:45:00Z"
      }
    ],
    "last_updated": "2025-04-12T16:45:00Z"
  }
}

Notes

  • This tool is read-only and does not modify any data (readOnlyHint: true).
  • This is the most efficient way to get an overview of project health : a single call returns what would otherwise require multiple queries across atoms_list_items, atoms_get_coverage, and atoms_get_history.
  • The coverage section identifies requirements that have no linked test cases, making it useful for compliance reviews and gap analysis.
  • The coverage_by_domain breakdown helps prioritize testing efforts by revealing which domains have the weakest coverage.
  • The recent_changes array shows the latest modifications across the project, ordered by most recent first.

On this page