# ProjectStatus

> Everything about a project in one call (the MCP project_status tool).

Everything about a project in one call (the MCP `project_status` tool).

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `project` * | [Project](/docs/api/objects/project/) |  |
| `headline` | string | One plain-English sentence. |
| `environments` * | array of object |  |
| `recent_deployments` | array of [Deployment](/docs/api/objects/deployment/) |  |
| `spend` | object |  |
| `safety_grade` | [SafetyGrade](/docs/api/objects/safety-grade/) or any or null |  |
| `pending_approvals` | integer |  |
| `open_incidents` | integer |  |

\* always present

## Example

```json
{
  "project": {
    "id": "prj_01jbx2m9k7q4r8t5v6w3y0z1pr",
    "workspace_id": "ws_01jbx2m9k7q4r8t5v6w3y0z1ws",
    "slug": "primecarers",
    "name": "Primecarers",
    "description": "Care management platform",
    "region": "lon1",
    "residency": "uk-only",
    "classification": "special-category",
    "repo": {
      "provider": "github",
      "full_name": "primecarers/platform",
      "installation_id": "ghi_01jbx2m9k7q4r8t5v6w3y0z1gh",
      "default_branch": "main",
      "manifest_path": "guv.yaml"
    },
    "managed_by_manifest": true,
    "safety": {
      "grade": "A",
      "evaluated_at": "2026-10-23T12:00:00Z",
      "badge_enabled": true,
      "badge_url": "https://guv.dev/safety/k7q4r8t5v6w3y0z1"
    },
    "created_at": "2026-10-22T09:30:00Z",
    "updated_at": "2026-10-23T12:00:00Z"
  },
  "headline": "All 4 services are live. £7.42 spent of your £400 cap this month. Safety grade A.",
  "environments": [
    {
      "id": "string",
      "name": "string",
      "status": "healthy",
      "services": [
        {
          "id": "string",
          "name": "string",
          "kind": "web",
          "status": "no_deployment",
          "url": "string",
          "current_deployment_id": "string",
          "last_error": "string",
          "cost_today": {
            "amount": "7.42",
            "currency": "GBP",
            "display": "£7.42"
          }
        }
      ],
      "databases": [
        {
          "id": "string",
          "name": "string",
          "engine": "string",
          "status": "string",
          "last_backup_at": "2026-10-22T13:05:00Z"
        }
      ]
    }
  ],
  "recent_deployments": [
    {
      "id": "dep_01jbx2m9k7q4r8t5v6w3y0z1dp",
      "project_id": "prj_01jbx2m9k7q4r8t5v6w3y0z1pr",
      "environment_id": "env_01jbx2m9k7q4r8t5v6w3y0z1en",
      "service_id": "svc_01jbx2m9k7q4r8t5v6w3y0z1sv",
      "service_name": "web",
      "environment_name": "production",
      "status": "active",
      "status_text": "Live since 14:05",
      "trigger": {
        "kind": "git_push",
        "actor": {
          "type": "github",
          "id": "stewartwebb",
          "display": "stewartwebb pushed to main"
        }
      },
      "source": {
        "kind": "git",
        "commit": {
          "sha": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
          "branch": "main",
          "message": "Fix rota export",
          "author": "Stewart Webb"
        }
      },
      "build_id": "bld_01jbx2m9k7q4r8t5v6w3y0z1bd",
      "image": {
        "digest": "sha256:4b1f0e9d8c7b6a5948372615f4e3d2c1b0a9f8e7d6c5b4a3928170f6e5d4c3b2",
        "signed": true
      },
      "rollback_of": null,
      "operation_id": "op_01jbx2m9k7q4r8t5v6w3y0z1op",
      "url": "https://www.primecarers.co.uk",
      "failure": null,
      "created_at": "2026-10-23T14:02:00Z",
      "started_at": "2026-10-23T14:02:01Z",
      "active_at": "2026-10-23T14:05:12Z",
      "finished_at": "2026-10-23T14:05:12Z",
      "duration_ms": 191000
    }
  ],
  "spend": {
    "month_to_date": {
      "amount": "7.42",
      "currency": "GBP",
      "display": "£7.42"
    },
    "forecast_month_end": {
      "amount": "7.42",
      "currency": "GBP",
      "display": "£7.42"
    },
    "cap": {
      "amount": "7.42",
      "currency": "GBP",
      "display": "£7.42"
    }
  },
  "safety_grade": "A",
  "pending_approvals": 1,
  "open_incidents": 1
}
```

## Used by

- [Everything about a project in one call](/docs/api/projects/#everything-about-a-project-in-one-call)