> ## Documentation Index
> Fetch the complete documentation index at: https://code.dcycle.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Project Tools
> MCP tools for querying ESG projects, tasks, and activity feeds
# Project Tools
Query ESG projects — reporting periods, task tracking, dashboards, and recent activity. Projects group data by framework (GHG Protocol, ISO 14064, LCA, etc.) and contain tasks, files, and dashboards.
## `list_projects`
List projects for the organization with optional framework filter.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------------- | ------ | -------- | ----------- | ---------------------------------- |
| `organization_id` | string | No | default org | Organization UUID |
| `framework` | string | No | — | Filter by project type (see below) |
| Value | Description |
| ---------------------- | --------------------------------------------------------------------- |
| `carbon_footprint` | GHG Protocol carbon footprint |
| `esrs` | European Sustainability Reporting Standards (EINF + ESRS methodology) |
| `gri` | Global Reporting Initiative (EINF + GRI methodology) |
| `lca` | Life Cycle Assessment |
| `logistics` | Logistics & GLEC framework |
| `decarbonization_plan` | Decarbonization planning |
| `custom` | Custom project |
**Example response:**
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
[
{
"id": "p5e6f7a8-...",
"name": "Carbon Footprint 2024",
"description": "Annual GHG Protocol reporting",
"project_type": "carbon_footprint",
"methodology": "gri",
"start_date": "2024-01-01",
"end_date": "2024-12-31",
"due_date": "2025-03-31",
"organization_id": "a1b2c3d4-...",
"responsible_user": {
"id": "u1a2b3c4-...",
"first_name": "María",
"last_name": "García",
"email": "maria@company.com"
},
"extended": {
"number_of_files": 45,
"number_of_widgets": 8,
"number_of_tasks": 12,
"number_of_tasks_completed": 7
},
"created_at": "2024-01-15T10:00:00",
"updated_at": "2025-02-20T14:30:00"
}
]
```
**Key response fields:**
| Field | Description |
| ------------------------- | --------------------------------------------------------- |
| `project_type` | Framework type (see project types above) |
| `methodology` | Reporting methodology: `esrs`, `gri`, `glec`, or `custom` |
| `start_date` / `end_date` | Reporting period |
| `due_date` | Project deadline |
| `responsible_user` | User responsible for the project |
| `extended` | Summary counts: files, widgets, tasks, tasks completed |
## `get_project`
Get a single project by ID with full details including progress metrics and responsible user.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------------- | ------ | -------- | ----------- | ------------------- |
| `project_id` | string | **Yes** | — | UUID of the project |
| `organization_id` | string | No | default org | Organization UUID |
**Example response:**
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"id": "p5e6f7a8-...",
"name": "Carbon Footprint 2024",
"description": "Annual GHG Protocol reporting for all facilities",
"project_type": "carbon_footprint",
"methodology": "gri",
"start_date": "2024-01-01",
"end_date": "2024-12-31",
"due_date": "2025-03-31",
"organization_id": "a1b2c3d4-...",
"responsible_user": {
"id": "u1a2b3c4-...",
"first_name": "María",
"last_name": "García",
"email": "maria@company.com"
},
"extended": {
"number_of_files": 45,
"number_of_widgets": 8,
"number_of_tasks": 12,
"number_of_tasks_completed": 7
},
"created_at": "2024-01-15T10:00:00",
"updated_at": "2025-02-20T14:30:00"
}
```
Use `list_projects` first to find project IDs, then `list_project_tasks` for the task breakdown.
## `list_project_tasks`
List tasks and subtasks within a project. Returns each task's status, assignee, due date, and nested subtasks — useful for tracking ESG action-item progress.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------------- | ------ | -------- | ----------- | ------------------- |
| `project_id` | string | **Yes** | — | UUID of the project |
| `organization_id` | string | No | default org | Organization UUID |
**Example response:**
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
[
{
"id": "task-1a2b3c4d-...",
"title": "Upload electricity invoices Q1-Q4",
"status": "done",
"assignee": {
"id": "u1a2b3c4-...",
"first_name": "María",
"last_name": "García"
},
"due_date": "2025-02-15",
"subtasks": [
{
"id": "task-5e6f7a8b-...",
"title": "Verify Q3 consumption data",
"status": "in_progress",
"assignee": null,
"due_date": null
}
]
},
{
"id": "task-9c0d1e2f-...",
"title": "Review Scope 3 emission factors",
"status": "pending",
"assignee": null,
"due_date": "2025-03-01",
"subtasks": []
}
]
```
**Key response fields:**
| Field | Description |
| ---------- | ------------------------------------------------------------- |
| `status` | Task state: `pending`, `in_progress`, or `done` |
| `assignee` | Organization member assigned to the task (null if unassigned) |
| `subtasks` | Nested array of child tasks with the same structure |
## `get_recent_activities`
Get the recent activity feed for a project — data uploads, task completions, and configuration changes.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------------- | ------- | -------- | ----------- | --------------------------- |
| `project_id` | string | **Yes** | — | UUID of the project |
| `organization_id` | string | No | default org | Organization UUID |
| `limit` | integer | No | 10 | Number of activities (1–50) |
**Example response:**
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
[
{
"id": "act-1a2b3c4d-...",
"action": "file_uploaded",
"description": "Uploaded electricity invoices for Barcelona office",
"user": {
"id": "u1a2b3c4-...",
"first_name": "María",
"last_name": "García"
},
"created_at": "2025-02-18T09:30:00"
},
{
"id": "act-5e6f7a8b-...",
"action": "task_completed",
"description": "Marked 'Upload electricity invoices Q1-Q4' as done",
"user": {
"id": "u1a2b3c4-...",
"first_name": "María",
"last_name": "García"
},
"created_at": "2025-02-17T16:45:00"
}
]
```
**Example prompts:**
```
"List all our ESG projects"
"Show our carbon footprint projects"
"What tasks are pending in our GHG project?"
"Show recent activity on the ISO 14064 project"
"Which projects are due this quarter?"
"How many tasks are completed in project abc-123?"
```
## Workflow
1. **List projects** — `list_projects` to discover available projects, optionally filtered by framework
2. **Get details** — `get_project` for full project information and responsible user
3. **Check tasks** — `list_project_tasks` to see task breakdown and completion status
4. **Track activity** — `get_recent_activities` for recent changes and data uploads
5. **View dashboards** — `list_dashboards` to find dashboards linked to the project
## Related
Dashboard widgets linked to projects
Decarbonization plans linked to projects
Organization members assigned to project tasks
REST API endpoints for projects
Manage projects from the command line