Organization Tools

Explore your organization — data summaries, corporate group hierarchy, and entity connections. These tools are the starting point for understanding what data is available before diving into specific categories.

`get_organization_metrics`

Get a summary of what data exists — counts of facilities, vehicles, employees, purchases, and more. Parameters:

Parameter	Type	Required	Default	Description
`organization_id`	string	No	default org	Organization UUID

Purchase and business travel counts reflect only active records. list_purchases and list_business_travels totals will be higher because they include all statuses (active, error, deleted) by default. To match these counts, filter those tools with status=active.

Example response:

{
  "limits": { "facilities": 50, "vehicles": 100, "employees": 100 },
  "facilities": 25,
  "vehicles": 69,
  "employees": 99,
  "purchases": 59197,
  "business_travels": 2349,
  "logistic_requests": 154522,
  "sold_products": 8,
  "social_governance": 3,
  "events": 2,
  "ms_risks": 5,
  "ms_opportunities": 2,
  "ms_nc_types": 7
}

Key response fields:

Field	Description
`limits`	Plan limits for facilities, vehicles, and employees
`facilities`	Number of active facilities
`purchases`	Active purchase records (Scope 3)
`business_travels`	Active business travel records (Scope 3)
`logistic_requests`	Logistics transport records (Scope 3)
`sold_products`	Sold product records (Scope 3)

`get_organization_tree`

Get the parent-child hierarchy tree. Useful for corporate groups with subsidiaries. Parameters:

Parameter	Type	Required	Default	Description
`organization_id`	string	No	default org	UUID of the root organization
`include_facilities`	boolean	No	false	Include facilities in each org node

Example response:

{
  "id": "cefc7985-...",
  "name": "Parent Corp",
  "children": [
    {
      "id": "a1b2c3d4-...",
      "name": "Spain Office",
      "children": []
    },
    {
      "id": "e5f6a7b8-...",
      "name": "Italy Branch",
      "children": [
        { "id": "c9d0e1f2-...", "name": "Milan Factory", "children": [] }
      ]
    }
  ]
}

`get_organization_canvas`

Get a canvas view of all organizations in the group with their sectors, countries, and connections. Parameters:

Parameter	Type	Required	Default	Description
`organization_id`	string	No	default org	Organization UUID

Example response:

[
  {
    "org_id": "cefc7985-...",
    "org_name": "Parent Corp",
    "country": "ES",
    "sector": "transport",
    "inputs": null,
    "outputs": ["a1b2c3d4-...", "e5f6a7b8-..."]
  },
  {
    "org_id": "a1b2c3d4-...",
    "org_name": "Spain Office",
    "country": "ES",
    "sector": "logistics",
    "inputs": ["cefc7985-..."],
    "outputs": null
  }
]

Key response fields:

Field	Description
`sector`	Industry sector of the organization
`country`	ISO country code
`inputs`	Parent organization UUIDs (upstream connections)
`outputs`	Child organization UUIDs (downstream connections)

Remote-Mode Tools

These tools are only available when connecting to the remote MCP server (https://mcp.dcycle.io), not in local mode.

`list_my_organizations`

List all organizations the authenticated user has access to. Use this to discover available organizations, then call set_default_organization to pick one.

`set_default_organization`

Set the default organization for the session. After calling this, all tools use this organization automatically without needing organization_id each time.

Parameter	Type	Required	Description
`organization_id`	string	Yes	UUID of the organization to use

Example prompts:

"How many facilities and vehicles do we have?"
"Give me an overview of our organization's data"
"Show me the organization structure"
"Which subsidiaries does my company have?"
"Show the org tree with facilities included"
"What companies are in our group and where are they?"

Workflow

Get overview — get_organization_metrics to see what data exists and plan limits
Explore hierarchy — get_organization_tree for parent-child structure (add include_facilities=true for site details)
View connections — get_organization_canvas for the full group map with sectors and countries
Dive into data — Use specific tools: list_facilities, list_vehicles, list_purchases, etc.

Facilities

Sites and locations within the organization

Members

Users and roles in the organization

Emissions

GHG emissions data for the organization

API Reference

REST API endpoints for organizations

CLI

Manage organizations from the command line

Getting Started

Tools Reference

Reference Data

Organization Tools

Organization Tools

`get_organization_metrics`

`get_organization_tree`

`get_organization_canvas`

Remote-Mode Tools

`list_my_organizations`

`set_default_organization`

Workflow

Facilities

Members

Emissions

API Reference

CLI

​Organization Tools

​get_organization_metrics

​get_organization_tree

​get_organization_canvas

​Remote-Mode Tools

​list_my_organizations

​set_default_organization

​Workflow

​Related

Facilities

Members

Emissions

API Reference

CLI

Organization Tools

`get_organization_metrics`

`get_organization_tree`

`get_organization_canvas`

Remote-Mode Tools

`list_my_organizations`

`set_default_organization`

Workflow

Related