Tools — Companies - Manglai API Documentation

Available Tools

Tool	Endpoint	Description
`get_companies`	`GET /api/v1/companies`	List of companies
`get_company_buildings`	`GET /api/v1/companies/{id}/buildings`	Buildings for a company
`get_company_departments`	`GET /api/v1/companies/{id}/departments`	Departments
`get_company_year_configuration`	`GET /api/v1/companies/{id}/year-configuration`	Active year configuration
`upsert_company_building`	`POST /api/v1/companies/{companyId}/buildings`	Create or update a building (two-step confirmation)

Usage Examples

"List all my companies"
→ get_companies()

"How many active parent companies are there?"
→ get_companies({ isRootCompany: true, status: ["accepted"], isTestCompany: false, limit: 1 })
→ read pagination.total

"What buildings does company ABC have?"
→ get_company_buildings({ id: "company-uuid" })

Building writes require userConfirmed: false (preview) then userConfirmed: true after user approval. See MCP intro and resource manglai://api/mutations/buildings.

Common Parameters

`get_companies`

Parameter	Type	Description
`page`	integer	Page number
`limit`	integer	Results per page (for counts: `limit=1` and read `pagination.total`)
`companyIds`	string[]	Filter by company IDs
`query`	string	Search by name or external id
`status`	string[]	Filter by status (`accepted`, `pending`, …)
`isRootCompany`	boolean	Parent/root companies only (`true`) or non-root (`false`)
`isTestCompany`	boolean	Test companies only (`true`) or exclude tests (`false`)
`showOnlyParents`	boolean	Organization parents only

Typical Response

{
  "data": [
    {
      "id": "1b1e07a7-083d-4831-a1d2-84b6e93a1572",
      "name": "My Company Inc.",
      "country": "US"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 3
  }
}