Skip to main content
Coming Soon - The Dcycle MCP Server is in private beta. Interested in AI integration? Contact us for early access.

​
Overview

Organization tools allow you to list, search, and explore the organizational structure in Dcycle. These are typically the first tools you’ll use to establish context before querying emissions data.

​
get_organization_summary

Get detailed information about a specific organization.

​
Parameters

ParameterTypeRequiredDescription
organization_idstringYesThe organization UUID

​
Example Query

"Show me a summary of organization ff4adcc7-8172-45fe-9cf1-e90a6de53aa9"

​
Response

{
  "id": "ff4adcc7-8172-45fe-9cf1-e90a6de53aa9",
  "name": "Acme Corp",
  "country": "ES",
  "sector": "Manufacturing",
  "status": "active",
  "employee_count": 250,
  "vat": "B12345678",
  "api_enabled": true,
  "subscription_plan": "Enterprise",
  "created_at": "2023-01-15T10:30:00Z"
}

​
Use Cases

  • Get organization details before running emissions queries
  • Verify you have the correct organization context
  • Check subscription plan and API access

​
list_organizations

List all organizations accessible to your API key.

​
Parameters

ParameterTypeRequiredDefaultDescription
pageintegerNo1Page number for pagination
sizeintegerNo50Items per page (max 100)

​
Example Query

"List all my organizations"

​
Response

{
  "organizations": [
    {
      "id": "ff4adcc7-8172-45fe-9cf1-e90a6de53aa9",
      "name": "Acme Corp",
      "country": "ES",
      "sector": "Manufacturing",
      "status": "active"
    },
    {
      "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "name": "Acme Logistics",
      "country": "ES",
      "sector": "Transport",
      "status": "active"
    }
  ],
  "total": 2,
  "page": 1,
  "size": 50
}

​
Use Cases

  • Discover which organizations you have access to
  • Get organization IDs for subsequent queries
  • Understand your organizational portfolio

​
search_organizations

Search organizations by various criteria.

​
Parameters

ParameterTypeRequiredDescription
querystringNoSearch query for organization name
countrystringNoFilter by country code (ES, FR, DE, etc.)
sectorstringNoFilter by sector
statusstringNoFilter by status (active, inactive)
pageintegerNoPage number
sizeintegerNoItems per page

​
Example Queries

"Find all organizations in Spain"

"Search for organizations with 'logistics' in the name"

"List active manufacturing companies"

​
Response

{
  "organizations": [
    {
      "id": "ff4adcc7-8172-45fe-9cf1-e90a6de53aa9",
      "name": "Acme Corp",
      "country": "ES",
      "sector": "Manufacturing",
      "status": "active"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 50,
  "filters_applied": {
    "query": null,
    "country": "ES",
    "sector": "Manufacturing",
    "status": "active"
  }
}

​
Use Cases

  • Find organizations in a specific country
  • Filter by sector for analysis
  • Narrow down to active organizations only

​
get_organization_tree

View the hierarchical structure of organizations (parent-child relationships).

​
Parameters

ParameterTypeRequiredDefaultDescription
organization_idstringYes-Organization UUID
from_rootbooleanNofalseIf true, show tree from root parent

​
Example Queries

"Show me the organization tree for Acme Corp"

"Show the full corporate hierarchy starting from the parent company"

​
Response

{
  "id": "root-org-id",
  "name": "Acme Holding Corp",
  "children": [
    {
      "id": "ff4adcc7-8172-45fe-9cf1-e90a6de53aa9",
      "name": "Acme Spain",
      "children": [
        {
          "id": "child-1-id",
          "name": "Acme Madrid"
        },
        {
          "id": "child-2-id",
          "name": "Acme Barcelona"
        }
      ]
    },
    {
      "id": "uk-org-id",
      "name": "Acme UK",
      "children": []
    }
  ]
}

​
Use Cases

  • Understand corporate structure for consolidated reporting
  • Identify subsidiaries under a holding company
  • Plan multi-organization emissions analysis

​
Common Workflows

​
Finding the Right Organization

User: "I need to check emissions for our Spanish subsidiary"

Claude: Let me search for organizations in Spain.
[Uses search_organizations with country="ES"]

Found 2 organizations:
1. Acme Spain (ff4adcc7-...)
2. Acme Logistics Spain (a1b2c3d4-...)

Which organization would you like to analyze?

​
Understanding Corporate Structure

User: "Show me the full structure of our holding company"

Claude: Let me get the organization tree from the root.
[Uses get_organization_tree with from_root=true]

Acme Holding Corp
├── Acme Spain
│   ├── Acme Madrid
│   └── Acme Barcelona
├── Acme UK
│   └── Acme London
└── Acme Logistics

​
Pre-Query Context

User: "What are the emissions for our main company?"

Claude: Let me first identify your organizations and then get the emissions data.
[Uses list_organizations]
[Uses get_organization_summary for the selected org]
[Then proceeds to emissions queries]

​
Next Steps

Emissions Tools

Query emissions data by scope and category

Facilities Tools

Explore facilities and their emissions