GraphOS MCP Server

GetLintResults

Read-onlyIdempotent

Retrieve schema lint violations from a graph's most recent schema checks: each diagnostic's coordinate, severity level, message, rule, and source location, plus error/warning/total/ignored counts. Use to assess schema quality and naming/best-practice violations. Provide the graph ID and optionally a limit (default 5 most recent schema checks).

Input Schema

Name	Required	Description	Default
`limit`	No
`graphId`	Yes

Output Schema

Name	Required	Description	Default
`data`	No
`errors`	No
`extensions`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedSep 18, 2026

addedInput schema / properties / limit / default
```
Added value: +5
```

changedInput schema / required

Previous value: -[
-  "graphId",
-  "limit"
-]New value: +[
+  "graphId"
+]

addedOutput schema / properties / data / properties / graph / anyOf

Added value: +[
+  {
+    "properties": {
+      "checkWorkflows": {
+        "description": "Get check workflows for this graph ordered by creation time, most recent first.",
+        "items": {
+          "properties": {
+            "completedAt": {
+              "anyOf": [
+                {
+                  "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "The timestamp when the check workflow completed."
+            },
+            "id": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "integer"
+                }
+              ]
+            },
+            "implementingServiceName": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "The name of the implementing service that was responsible for triggering the validation."
+            },
+            "status": {
+              "$ref": "#/definitions/CheckWorkflowStatus",
+              "description": "Overall status of the workflow, based on the underlying task statuses."
+            },
+            "tasks": {
+              "description": "The set of check tasks associated with this workflow, e.g. composition, operations, etc.",
+              "items": {
+                "properties": {
+                  "result": {
+                    "anyOf": [
+                      {
+                        "properties": {
+                          "diagnostics": {
+                            "description": "The set of lint rule violations found in the schema.",
+                            "items": {
+                              "properties": {
+                                "coordinate": {
+                                  "description": "The schema coordinate of this diagnostic.",
+                                  "type": "string"
+                                },
+                                "level": {
+                                  "$ref": "#/definitions/LintDiagnosticLevel",
+                                  "description": "The graph's configured level for the rule."
+                                },
+                                "message": {
+                                  "description": "The message describing the rule violation.",
+                                  "type": "string"
+                                },
+                                "rule": {
+                                  "$ref": "#/definitions/LintRule",
+                                  "description": "The lint rule being violated."
+                                },
+                                "sourceLocations": {
+                                  "description": "The human readable position in the file of the rule violation.",
+                                  "items": {
+                                    "properties": {
+                                      "end": {
+                                        "anyOf": [
+                                          {
+                                            "properties": {
+                                              "column": {
+                                                "type": "integer"
+                                              },
+                                              "line": {
+                                                "type": "integer"
+                                              }
+                                            },
+                                            "required": [
+                                              "line",
+                                              "column"
+                                            ],
+                                            "type": "object"
+                                          },
+                                          {
+                                            "type": "null"
+                                          }
+                                        ]
+                                      },
+                                      "start": {
+                                        "anyOf": [
+                                          {
+                                            "properties": {
+                                              "column": {
+                                                "type": "integer"
+                                              },
+                                              "line": {
+                                                "type": "integer"
+                                              }
+                                            },
+                                            "required": [
+                                              "line",
+                                              "column"
+                                            ],
+                                            "type": "object"
+                                          },
+                                          {
+                                            "type": "null"
+                                          }
+                                        ]
+                                      },
+                                      "subgraphName": {
+                                        "anyOf": [
+                                          {
+                                            "type": "string"
+                                          },
+                                          {
+                                            "type": "null"
+                                          }
+                                        ]
+                                      }
+                                    },
+                                    "type": "object"
+                                  },
+                                  "type": "array"
+                                }
+                              },
+                              "required": [
+                                "coordinate",
+                                "level",
+                                "message",
+                                "rule",
+                                "sourceLocations"
+                              ],
+                              "type": "object"
+                            },
+                            "type": "array"
+                          },
+                          "stats": {
+                            "description": "Stats generated from the resulting diagnostics.",
+                            "properties": {
+                              "errorsCount": {
+                                "description": "Total number of lint errors.",
+                                "type": "integer"
+                              },
+                              "ignoredCount": {
+                                "description": "Total number of lint rules ignored.",
+                                "type": "integer"
+                              },
+                              "totalCount": {
+                                "description": "Total number of lint rules violated.",
+                                "type": "integer"
+                              },
+                              "warningsCount": {
+                                "description": "Total number of lint warnings.",
+                                "type": "integer"
+                              }
+                            },
+                            "required": [
+                              "errorsCount",
+                              "warningsCount",
+                              "totalCount",
+                              "ignoredCount"
+                            ],
+                            "type": "object"
+                          }
+                        },
+                        "required": [
+                          "diagnostics",
+                          "stats"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "status": {
+                    "$ref": "#/definitions/CheckWorkflowTaskStatus"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "id",
+            "status",
+            "tasks"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "checkWorkflows"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / data / properties / graph / oneOf

Removed value: -[
-  {
-    "properties": {
-      "checkWorkflows": {
-        "description": "Get check workflows for this graph ordered by creation time, most recent first.",
-        "items": {
-          "properties": {
-            "completedAt": {
-              "description": "The timestamp when the check workflow completed.",
-              "oneOf": [
-                {
-                  "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "id": {
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "integer"
-                }
-              ]
-            },
-            "implementingServiceName": {
-              "description": "The name of the implementing service that was responsible for triggering the validation.",
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "status": {
-              "$ref": "#/definitions/CheckWorkflowStatus",
-              "description": "Overall status of the workflow, based on the underlying task statuses."
-            },
-            "tasks": {
-              "description": "The set of check tasks associated with this workflow, e.g. composition, operations, etc.",
-              "items": {
-                "properties": {
-                  "result": {
-                    "oneOf": [
-                      {
-                        "properties": {
-                          "diagnostics": {
-                            "description": "The set of lint rule violations found in the schema.",
-                            "items": {
-                              "properties": {
-                                "coordinate": {
-                                  "description": "The schema coordinate of this diagnostic.",
-                                  "type": "string"
-                                },
-                                "level": {
-                                  "$ref": "#/definitions/LintDiagnosticLevel",
-                                  "description": "The graph's configured level for the rule."
-                                },
-                                "message": {
-                                  "description": "The message describing the rule violation.",
-                                  "type": "string"
-                                },
-                                "rule": {
-                                  "$ref": "#/definitions/LintRule",
-                                  "description": "The lint rule being violated."
-                                },
-                                "sourceLocations": {
-                                  "description": "The human readable position in the file of the rule violation.",
-                                  "items": {
-                                    "properties": {
-                                      "end": {
-                                        "oneOf": [
-                                          {
-                                            "properties": {
-                                              "column": {
-                                                "type": "integer"
-                                              },
-                                              "line": {
-                                                "type": "integer"
-                                              }
-                                            },
-                                            "required": [
-                                              "line",
-                                              "column"
-                                            ],
-                                            "type": "object"
-                                          },
-                                          {
-                                            "type": "null"
-                                          }
-                                        ]
-                                      },
-                                      "start": {
-                                        "oneOf": [
-                                          {
-                                            "properties": {
-                                              "column": {
-                                                "type": "integer"
-                                              },
-                                              "line": {
-                                                "type": "integer"
-                                              }
-                                            },
-                                            "required": [
-                                              "line",
-                                              "column"
-                                            ],
-                                            "type": "object"
-                                          },
-                                          {
-                                            "type": "null"
-                                          }
-                                        ]
-                                      },
-                                      "subgraphName": {
-                                        "oneOf": [
-                                          {
-                                            "type": "string"
-                                          },
-                                          {
-                                            "type": "null"
-                                          }
-                                        ]
-                                      }
-                                    },
-                                    "type": "object"
-                                  },
-                                  "type": "array"
-                                }
-                              },
-                              "required": [
-                                "coordinate",
-                                "level",
-                                "message",
-                                "rule",
-                                "sourceLocations"
-                              ],
-                              "type": "object"
-                            },
-                            "type": "array"
-                          },
-                          "stats": {
-                            "description": "Stats generated from the resulting diagnostics.",
-                            "properties": {
-                              "errorsCount": {
-                                "description": "Total number of lint errors.",
-                                "type": "integer"
-                              },
-                              "ignoredCount": {
-                                "description": "Total number of lint rules ignored.",
-                                "type": "integer"
-                              },
-                              "totalCount": {
-                                "description": "Total number of lint rules violated.",
-                                "type": "integer"
-                              },
-                              "warningsCount": {
-                                "description": "Total number of lint warnings.",
-                                "type": "integer"
-                              }
-                            },
-                            "required": [
-                              "errorsCount",
-                              "warningsCount",
-                              "totalCount",
-                              "ignoredCount"
-                            ],
-                            "type": "object"
-                          }
-                        },
-                        "required": [
-                          "diagnostics",
-                          "stats"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "status": {
-                    "$ref": "#/definitions/CheckWorkflowTaskStatus"
-                  }
-                },
-                "type": "object"
-              },
-              "type": "array"
-            }
-          },
-          "required": [
-            "id",
-            "status",
-            "tasks"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "checkWorkflows"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]

First observedAug 3, 2026

TDQS

A3.7/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, openWorldHint and destructiveHint=false, so safety is covered. The description adds scoping context (results come from the most recent schema checks, default 5) but says nothing about what happens when a graph has no checks, how results are ordered, or limits on volume.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences: scope of data returned, purpose, then parameters. Front-loaded and free of filler; every sentence adds information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-value detail is not required, and the description still outlines the payload plus counts. For a simple two-parameter read tool this is nearly complete; only empty-result and defaulting behavior are unaddressed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must carry the load. It explains that graphId identifies the graph and, critically, that limit means the number of most recent schema checks to include (default 5) – a meaning the bare integer schema does not convey.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: retrieve schema lint violations from a graph's most recent schema checks, and enumerates the diagnostic fields returned. It is clearly distinct from LintSchema (which runs linting) and GetSchemaChecks, but it never names those siblings to reinforce the distinction.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"Use to assess schema quality and naming/best-practice violations" gives implied usage context only. There is no explicit when-not guidance and no mention of alternatives such as LintSchema (to run lint) or GetCheckResults (for full check results), so the agent must infer the boundary itself.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All GraphOS MCP Server tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?