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
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string (UUID) | Yes | The 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, andatoms_get_history. - The
coveragesection identifies requirements that have no linked test cases, making it useful for compliance reviews and gap analysis. - The
coverage_by_domainbreakdown helps prioritize testing efforts by revealing which domains have the weakest coverage. - The
recent_changesarray shows the latest modifications across the project, ordered by most recent first.