MCP tools

mastercss_package_graph

Report Master CSS workspace package ownership, scripts, exports, workspace dependencies, and dependents.

Contract

Inspect workspace package ownership and dependency relationships without traversing the installed node_modules tree.

Input

packageName
stringOptional

Exact package name or repository-relative package path. Omit to return all discovered packages.

includeExamples
booleanOptional

Include packages under examples/. Defaults to true.

Complete input schema
JSON
{  "$schema": "http://json-schema.org/draft-07/schema#",  "type": "object",  "properties": {    "packageName": {      "type": "string"    },    "includeExamples": {      "type": "boolean"    }  }}

Example

Call mastercss_package_graph from a connected MCP client with these arguments:

Arguments
{  "includeExamples": false}

Inspect the connected workspace’s package graph without example packages.

Output

packages contains names, paths, package kinds, scripts, exports, internal workspace dependencies, dependents, and AI-note paths. summary counts returned packages. status: limited identifies a generic workspace outside the Master CSS repository.

Every tool returns an object with version: 3, metadata, diagnostics and result. Success payload fields described above live in result.data; failure has result.status: "error" and a required { code, message } error. JSON text equals structuredContent. Tool errors set isError. Metadata records actual context, package/language/binding versions, manifest fingerprint, entries and dependencies; unavailable information is null or an empty array.

Complete output schema
JSON
{  "$schema": "http://json-schema.org/draft-07/schema#",  "type": "object",  "properties": {    "version": {      "type": "number",      "const": 3    },    "metadata": {      "type": "object",      "properties": {        "versions": {          "anyOf": [            {              "type": "object",              "properties": {                "languageVersion": {                  "type": "number"                },                "bindingAbiVersion": {                  "type": "number"                },                "packageVersion": {                  "type": "string"                }              },              "required": [                "languageVersion",                "bindingAbiVersion",                "packageVersion"              ],              "additionalProperties": {}            },            {              "type": "null"            }          ]        },        "context": {          "anyOf": [            {              "type": "string",              "enum": [                "project",                "preset"              ]            },            {              "type": "null"            }          ]        },        "manifestFingerprint": {          "type": [            "string",            "null"          ]        },        "entries": {          "type": "array",          "items": {            "type": "string"          }        },        "dependencies": {          "type": "array",          "items": {            "type": "string"          }        }      },      "required": [        "versions",        "context",        "manifestFingerprint",        "entries",        "dependencies"      ],      "additionalProperties": false    },    "diagnostics": {      "type": "array",      "items": {        "type": "object",        "properties": {          "code": {            "type": "string"          },          "phase": {            "type": "string"          },          "severity": {            "type": [              "string",              "number"            ]          },          "message": {            "type": "string"          },          "notes": {            "type": "array",            "items": {              "type": "string"            }          },          "alternatives": {            "type": "array",            "items": {              "type": "string"            }          },          "source": {            "type": "string"          },          "range": {            "anyOf": [              {                "type": "object",                "properties": {                  "start": {                    "type": "number"                  },                  "end": {                    "type": "number"                  }                },                "required": [                  "start",                  "end"                ],                "additionalProperties": false              },              {                "type": "object",                "properties": {                  "start": {                    "type": "object",                    "properties": {                      "line": {                        "type": "number"                      },                      "character": {                        "type": "number"                      }                    },                    "required": [                      "line",                      "character"                    ],                    "additionalProperties": false                  },                  "end": {                    "type": "object",                    "properties": {                      "line": {                        "type": "number"                      },                      "character": {                        "type": "number"                      }                    },                    "required": [                      "line",                      "character"                    ],                    "additionalProperties": false                  }                },                "required": [                  "start",                  "end"                ],                "additionalProperties": false              }            ]          }        },        "required": [          "message"        ],        "additionalProperties": {}      }    },    "result": {      "oneOf": [        {          "type": "object",          "properties": {            "status": {              "type": "string",              "const": "success"            },            "data": {              "type": "object",              "properties": {                "root": {                  "type": "string"                },                "status": {                  "type": "string",                  "enum": [                    "loaded",                    "limited"                  ]                },                "packages": {                  "type": "array",                  "items": {                    "type": "object",                    "propertyNames": {                      "type": "string"                    },                    "additionalProperties": {                      "$ref": "#/definitions/__schema0"                    }                  }                },                "summary": {                  "type": "object",                  "propertyNames": {                    "type": "string"                  },                  "additionalProperties": {                    "$ref": "#/definitions/__schema0"                  }                }              },              "required": [                "root",                "status",                "packages",                "summary"              ],              "additionalProperties": {}            }          },          "required": [            "status",            "data"          ],          "additionalProperties": false        },        {          "type": "object",          "properties": {            "status": {              "type": "string",              "const": "error"            },            "error": {              "type": "object",              "properties": {                "code": {                  "type": "string"                },                "message": {                  "type": "string"                }              },              "required": [                "code",                "message"              ],              "additionalProperties": false            }          },          "required": [            "status",            "error"          ],          "additionalProperties": false        }      ]    }  },  "required": [    "version",    "metadata",    "diagnostics",    "result"  ],  "additionalProperties": false,  "definitions": {    "__schema0": {      "anyOf": [        {          "type": "string"        },        {          "type": "number"        },        {          "type": "boolean"        },        {          "type": "null"        },        {          "type": "array",          "items": {            "$ref": "#/definitions/__schema0"          }        },        {          "type": "object",          "propertyNames": {            "type": "string"          },          "additionalProperties": {            "$ref": "#/definitions/__schema0"          }        }      ]    }  }}

Project context and lifecycle

This operation reads repository metadata and does not edit files or run validation commands. Routing is designed for the Master CSS repository. Other workspaces report status: limited; missing recommendations do not establish that a change needs no checks.

The local stdio server uses the workspace passed to --root. Confirm the root and intended CSS entries with mastercss_workspace_info before relying on project-dependent values.

See the MCP workflow guide for client setup and the preview/apply workflow.


© 2026 Aoyue Design LLC.MIT License
Trademark Policy