Developer-tools MCP server

Semiotic

Version history of discovered tools, schemas, and declared agent authority.

View watchlist

DistributionDistribution: npm
Packagesemiotic
Latest analyzed version3.13.3
Current tool count24
Latest analysisNov 16, 2026
Package source

OBSERVED INTERFACE

Capability surface

Modelara’s observed declarations are shown separately from its derived effect classifications.

3 releases analyzed3.13.1 → 3.13.3Latest: 3.13.3
  • read24
  • write0
  • destructive0
  • unknown0

Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.

Package
semiotic@3.13.3
Registry
npm
Published
Oct 29, 2026
Integrity
sha512-judhu/D8iBkRBYFkel1tgrjksJrcJ/o5+zACX6Wk65mf5QN5vUN9GHytfCLriA/V+CO7Kvk2t7NC8BMFzozOpg==
Analyzer
modelara v0.1.8 · policy not recorded
Repository
https://github.com/nteract/semiotic

24 capabilities

CapabilityTypeDerived effectFirst observed in Valyd coverageLast changed
applyThementeract-semiotic:tool:applyTheme
Observed interface and hashes

Get usage instructions for a named Semiotic theme preset. Returns ThemeProvider examples, CSS custom properties, and design token export patterns. Available themes: light, dark, high-contrast, pastels, pastels-dark, bi-tool, bi-tool-dark, italian, italian-dark, tufte, tufte-dark, journalist, journalist-dark, playful, playful-dark, carbon, carbon-dark.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "name": {
      "description": "Theme preset name, e.g. 'tufte', 'pastels-dark', 'bi-tool'. Omit to list all available themes.",
      "type": "string"
    }
  },
  "type": "object"
}
sha256:c5f162be82b182260a8ba2f91cf530888931b7eb6e152b7bb50ecb2c21a084c0

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:815eb711ebf1c3d41712cb805dec2df93e294dee484c54a8423efbe33a263a7c

Interface hash: sha256:f9bb02f790d2112108a84377f2a4cfa644de7f095e35b6e9b4136125dee56cdc

Other observed Modelara metadata
{
  "id": "mcp:semiotic/applyTheme",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "applyTheme"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:bad563456eb83ac03f4ae2c6856a7c2ba47f1bfed044b1b55f7ba6166f9f3d6d"
}
toolread3.13.1No change observed
auditAccessibilitynteract-semiotic:tool:auditAccessibility
Observed interface and hashes

Audit a Semiotic chart configuration against the Chartability (POUR-CAF) accessibility framework — Perceivable, Operable, Understandable, Robust, Compromising, Assistive, Flexible. Statically grades the config (no DOM/AT): credits the built-ins every HOC ships (keyboard nav, focus ring, skip link, screen-reader data table, reduced-motion + forced-colors, shareable state), flags author-actionable gaps (missing title/description/summary, low contrast, small text, color-only encoding, undescribed trends, data density), and routes everything that needs real assistive-technology testing to a 'manual' item. Returns a per-principle report with the 14 critical heuristics marked. Pass inChartContainer=true to credit data-download/share affordances. Pair with manual NVDA/JAWS/VoiceOver testing — Chartability is not a pass/fail certification.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Chart component name, e.g. 'LineChart'",
      "type": "string"
    },
    "describe": {
      "description": "True if ChartContainer's describe option (auto-generated L1–L3 description via describeChart) is enabled — passes the 'features described' heuristic.",
      "type": "boolean"
    },
    "inChartContainer": {
      "description": "True if the chart is (or will be) wrapped in a ChartContainer exposing data-download/copy-config actions.",
      "type": "boolean"
    },
    "navigable": {
      "description": "True if ChartContainer's navigable option (structured navigation tree via buildNavigationTree) is enabled — passes the 'navigable structure' heuristic.",
      "type": "boolean"
    },
    "props": {
      "additionalProperties": {},
      "description": "Chart props object, e.g. { data: [...], xAccessor: 'x', title: '...' }.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    }
  },
  "required": [
    "component"
  ],
  "type": "object"
}
sha256:028cd6df5a27cb1d470fa2a6472350c0eb104fd191bdabb2412513d8680f60eb

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:9ce15f8c14e19ed62adb4115e9b34c70afc530ba253b0938297abde3f030ca60

Interface hash: sha256:ed65f30b9f9e5de1f0417a2bd3b6df54fc5bd553a5b8f2139ee7262b906e53c8

Other observed Modelara metadata
{
  "id": "mcp:semiotic/auditAccessibility",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "auditAccessibility"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:2774c9217beadec6c029144874077cebbd38845ac98a6180029d590b531db7f5"
}
toolread3.13.1No change observed
auditArtifactnteract-semiotic:tool:auditArtifact
Observed interface and hashes

Evaluate a chart and its explicit artifact contract under a named policy. The tool audits only supplied claims, evidence, source identity, review state, and time state; missing facts remain missing or unknown. Results are capped and report truncation explicitly.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Semiotic component name.",
      "type": "string"
    },
    "contract": {
      "additionalProperties": {},
      "description": "Complete explicit artifact contract. Validate against semiotic://artifact-contract-schema; omitted source, review, and time facts stay omitted or explicitly unknown.",
      "properties": {
        "artifact": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "claims": {
          "items": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "contractVersion": {
          "type": "string"
        },
        "evidence": {
          "items": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "purpose": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        }
      },
      "required": [
        "contractVersion",
        "artifact",
        "purpose",
        "claims",
        "evidence"
      ],
      "type": "object"
    },
    "data": {
      "description": "Optional explicit row data overriding props.data.",
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "maxItems": 10000,
      "type": "array"
    },
    "exceptions": {
      "items": {
        "additionalProperties": false,
        "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
        "properties": {
          "expiresAt": {
            "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
            "maxLength": 64,
            "type": "string"
          },
          "owner": {
            "maxLength": 240,
            "minLength": 1,
            "type": "string"
          },
          "rationale": {
            "maxLength": 1200,
            "minLength": 1,
            "type": "string"
          },
          "reviewAt": {
            "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
            "maxLength": 64,
            "type": "string"
          },
          "rule": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "rule",
          "rationale",
          "owner"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "type": "array"
    },
    "now": {
      "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
      "maxLength": 64,
      "type": "string"
    },
    "policyId": {
      "description": "Explicit built-in policy identifier used for this operation.",
      "enum": [
        "exploratory",
        "operational-streaming",
        "editorial",
        "public-civic",
        "agent-generated"
      ],
      "type": "string"
    },
    "props": {
      "additionalProperties": {},
      "description": "Chart props/config. Data may be supplied here or separately.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    }
  },
  "required": [
    "component",
    "contract",
    "policyId"
  ],
  "type": "object"
}
sha256:5baa015ae5df4c7b341a104ca915f484c2f1ce56136b1d24b5c6dac430719bac

Output schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "alternatives": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "caveats": {
            "items": {
              "type": "string"
            },
            "maxItems": 8,
            "type": "array"
          },
          "component": {
            "type": "string"
          },
          "id": {
            "maxLength": 240,
            "type": "string"
          },
          "kind": {
            "enum": [
              "chart",
              "custom-recipe",
              "table",
              "text",
              "small-multiples",
              "collect-more-data",
              "wait-for-settlement",
              "no-comparison",
              "no-claim",
              "no-action"
            ],
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "props": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 8,
            "type": "array"
          },
          "score": {
            "type": "number"
          }
        },
        "required": [
          "id",
          "kind",
          "label",
          "reasons"
        ],
        "type": "object"
      },
      "maxItems": 8,
      "type": "array"
    },
    "claimSummary": {
      "additionalProperties": false,
      "properties": {
        "fail": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "manual": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "notApplicable": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "pass": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "unknown": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "warn": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "pass",
        "fail",
        "warn",
        "manual",
        "unknown",
        "notApplicable"
      ],
      "type": "object"
    },
    "contractValidation": {
      "additionalProperties": false,
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "message": {
                "type": "string"
              },
              "path": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "message"
            ],
            "type": "object"
          },
          "maxItems": 25,
          "type": "array"
        },
        "valid": {
          "type": "boolean"
        },
        "warnings": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "message": {
                "type": "string"
              },
              "path": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "message"
            ],
            "type": "object"
          },
          "maxItems": 25,
          "type": "array"
        }
      },
      "required": [
        "valid",
        "errors",
        "warnings"
      ],
      "type": "object"
    },
    "manualChecks": {
      "items": {
        "type": "string"
      },
      "maxItems": 25,
      "type": "array"
    },
    "obligationSummary": {
      "additionalProperties": false,
      "properties": {
        "fail": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "manual": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "notApplicable": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "pass": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "unknown": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "warn": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "pass",
        "fail",
        "warn",
        "manual",
        "unknown",
        "notApplicable"
      ],
      "type": "object"
    },
    "obligations": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "evidenceIds": {
            "items": {
              "type": "string"
            },
            "maxItems": 25,
            "type": "array"
          },
          "id": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "relation": {
            "enum": [
              "claim-support",
              "representation-fit",
              "reception",
              "time",
              "challenge-and-correction",
              "accountability",
              "abstention",
              "preservation"
            ],
            "type": "string"
          },
          "repair": {
            "type": "string"
          },
          "status": {
            "enum": [
              "pass",
              "fail",
              "warn",
              "manual",
              "unknown",
              "not-applicable"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "relation",
          "status",
          "message"
        ],
        "type": "object"
      },
      "maxItems": 50,
      "type": "array"
    },
    "policy": {
      "additionalProperties": false,
      "properties": {
        "appliedExceptions": {
          "items": {
            "additionalProperties": false,
            "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
            "properties": {
              "expiresAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "owner": {
                "maxLength": 240,
                "minLength": 1,
                "type": "string"
              },
              "rationale": {
                "maxLength": 1200,
                "minLength": 1,
                "type": "string"
              },
              "reviewAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "rule": {
                "maxLength": 120,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "rule",
              "rationale",
              "owner"
            ],
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "id": {
          "type": "string"
        },
        "rejectedExceptions": {
          "items": {
            "additionalProperties": false,
            "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
            "properties": {
              "expiresAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "owner": {
                "maxLength": 240,
                "minLength": 1,
                "type": "string"
              },
              "rationale": {
                "maxLength": 1200,
                "minLength": 1,
                "type": "string"
              },
              "reviewAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "rule": {
                "maxLength": 120,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "rule",
              "rationale",
              "owner"
            ],
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "version": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "version"
      ],
      "type": "object"
    },
    "repairs": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string"
          },
          "category": {
            "enum": [
              "identity",
              "configuration",
              "contract"
            ],
            "type": "string"
          },
          "changesClaim": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "action",
          "reason",
          "changesClaim"
        ],
        "type": "object"
      },
      "maxItems": 50,
      "type": "array"
    },
    "selectedRepresentation": {
      "additionalProperties": false,
      "properties": {
        "caveats": {
          "items": {
            "type": "string"
          },
          "maxItems": 8,
          "type": "array"
        },
        "component": {
          "type": "string"
        },
        "id": {
          "maxLength": 240,
          "type": "string"
        },
        "kind": {
          "enum": [
            "chart",
            "custom-recipe",
            "table",
            "text",
            "small-multiples",
            "collect-more-data",
            "wait-for-settlement",
            "no-comparison",
            "no-claim",
            "no-action"
          ],
          "type": "string"
        },
        "label": {
          "type": "string"
        },
        "props": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "reasons": {
          "items": {
            "type": "string"
          },
          "maxItems": 8,
          "type": "array"
        },
        "score": {
          "type": "number"
        }
      },
      "required": [
        "id",
        "kind",
        "label",
        "reasons"
      ],
      "type": "object"
    },
    "status": {
      "enum": [
        "acceptable",
        "conditional",
        "refuse",
        "invalid-contract"
      ],
      "type": "string"
    },
    "surfaceVersion": {
      "type": "string"
    },
    "temporalSummary": {
      "additionalProperties": false,
      "properties": {
        "fail": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "manual": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "notApplicable": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "pass": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "unknown": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        },
        "warn": {
          "maximum": 9007199254740991,
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "pass",
        "fail",
        "warn",
        "manual",
        "unknown",
        "notApplicable"
      ],
      "type": "object"
    },
    "truncated": {
      "additionalProperties": false,
      "properties": {
        "alternatives": {
          "type": "boolean"
        },
        "manualChecks": {
          "type": "boolean"
        },
        "obligations": {
          "type": "boolean"
        },
        "repairs": {
          "type": "boolean"
        }
      },
      "required": [
        "obligations",
        "alternatives",
        "repairs",
        "manualChecks"
      ],
      "type": "object"
    }
  },
  "required": [
    "status",
    "policy",
    "contractValidation",
    "surfaceVersion"
  ],
  "type": "object"
}
sha256:064a51e2d6d8bc0515b0a80e1b1c94e9293684bca3f9231d798bdbbc1ef63609

Description hash: sha256:ad3ef0d35b3bd685c586268b33ba870d3f1c7ac878070ff8cb13edec1e0ab036

Interface hash: sha256:498e30686f0b7b7986f884402321ae11f5e7253278e8982c83f6df7e94cf09e7

Other observed Modelara metadata
{
  "id": "mcp:semiotic/auditArtifact",
  "title": "Audit an explicit artifact contract",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "auditArtifact"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:d918b7b484ac5f866d0786b819b13483e6a403de0c5d099a1854b49127779727"
}
toolread3.13.1No change observed
auditMobileVisualizationnteract-semiotic:tool:auditMobileVisualization
Observed interface and hashes

Audit a Semiotic chart configuration for mobile visualization risks. Use before generating phone-sized charts or when adapting a desktop chart to mobile. Flags fixed desktop widths, rough mark-density overload, hover-only detail, small touch targets, complex gestures without controls, legend dependence, annotation overload, and missing mobile transformation hints. Static analysis only: still verify rendered charts at phone widths.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Chart component name, e.g. 'LineChart', 'Scatterplot', or 'BarChart'.",
      "type": "string"
    },
    "inChartContainer": {
      "description": "Whether the chart is wrapped in ChartContainer or an equivalent summary/control surface.",
      "type": "boolean"
    },
    "props": {
      "additionalProperties": {},
      "description": "Chart props/config to audit.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "targetSize": {
      "description": "Desired comfortable touch target size in CSS pixels. Defaults to 44.",
      "maximum": 80,
      "minimum": 24,
      "type": "integer"
    },
    "viewportWidth": {
      "description": "Mobile viewport width in CSS pixels. Defaults to 390.",
      "maximum": 1600,
      "minimum": 240,
      "type": "integer"
    }
  },
  "required": [
    "component"
  ],
  "type": "object"
}
sha256:dadfdf383dd14e7b4bd0780d42e8053fce94b55cb65d54ed1326b3636d4f82ef

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:50cc8eb277f38b22bb91152409d2da5f0b94a678b36d77b00c9de016d526b890

Interface hash: sha256:30785f5b46086232d8376ae3175d56dad70a8cf7a12864225e68dd4f2c769a94

Other observed Modelara metadata
{
  "id": "mcp:semiotic/auditMobileVisualization",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "auditMobileVisualization"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:85611828f1456b25040e0b1c1ddd5dfce2cebcf3a072514e56c8e9f9e76b3ab2"
}
toolread3.13.1No change observed
diagnoseConfignteract-semiotic:tool:diagnoseConfig
Observed interface and hashes

Diagnose a Semiotic chart configuration for common problems (empty data, bad dimensions, missing accessors, wrong data shape, color contrast issues, etc). Pass usageMode='push' for ref-based React HOCs that intentionally omit data; omit usageMode or pass 'static' for renderChart/MCP/server configs where data is required. Checks WCAG color contrast ratios and suggests COLOR_BLIND_SAFE_CATEGORICAL for accessibility. Returns a human-readable diagnostic report with actionable fixes.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Chart component name, e.g. 'LineChart'",
      "type": "string"
    },
    "props": {
      "additionalProperties": {},
      "description": "Chart props object, e.g. { data: [...], xAccessor: 'x' }.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "usageMode": {
      "description": "Validation mode. Use 'push' for ref-based React HOCs that omit data; use 'static' or omit for renderChart/MCP/static data configs.",
      "enum": [
        "static",
        "push",
        "renderChart",
        "server"
      ],
      "type": "string"
    }
  },
  "required": [
    "component"
  ],
  "type": "object"
}
sha256:4b1a5b28fca839ce6f5ede1518d9dbaff34fd195193080400ed0374039151764

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:f18e7cfdae33009da105638e090608f0090c754c25cda59613c682fa91942fac

Interface hash: sha256:9859e006f6c005f20e3e1b7e29e42d967699b7c3c4acc9de0c65642bc076e778

Other observed Modelara metadata
{
  "id": "mcp:semiotic/diagnoseConfig",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "diagnoseConfig"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:47971372519600aa8f32ce21e77eb0fe4732437c6534cee53a84ff090cd4bf6d"
}
toolread3.13.1No change observed
evaluateChartnteract-semiotic:tool:evaluateChart
Observed interface and hashes

Evaluate a Semiotic chart through one deterministic quality pass: numeric data contracts, configuration and representation/deception checks, and static Chartability accessibility heuristics. Returns the independent audit reports plus a severity-ranked findings list and notification feed. Pass data separately when it should override props.data; use inChartContainer, describe, or navigable to describe the intended accessibility wrapper. This is static analysis and does not replace manual assistive-technology testing or render evidence.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Chart component name, e.g. 'LineChart'.",
      "type": "string"
    },
    "data": {
      "description": "Optional explicit dataset. When supplied, this is used as the effective props.data for evaluation.",
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "type": "array"
    },
    "describe": {
      "description": "Whether ChartContainer's generated description is enabled.",
      "type": "boolean"
    },
    "inChartContainer": {
      "description": "Whether the chart will be wrapped in ChartContainer or an equivalent control surface.",
      "type": "boolean"
    },
    "navigable": {
      "description": "Whether ChartContainer's structured navigation tree is enabled.",
      "type": "boolean"
    },
    "props": {
      "additionalProperties": {},
      "description": "Chart props/config, including accessors and optional data.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    }
  },
  "required": [
    "component"
  ],
  "type": "object"
}
sha256:c8eea0dcc55068ff908bdfb38ada222166dd061dd3edf49d24e6957c8e23ba78

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:b4246df95a63fca64459f8b10f28899d87b919a57b5d357835f735b52415d308

Interface hash: sha256:7e279ec1418b7cfab4eaae1aaed772eb03a7ae622e8c141aff2988ebce92ce94

Other observed Modelara metadata
{
  "id": "mcp:semiotic/evaluateChart",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "evaluateChart"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:18253f677697ab36481b879e2b989844a06d46705e11686cfa7a29e81f2f6626"
}
toolread3.13.1No change observed
explainRefusalnteract-semiotic:tool:explainRefusal
Observed interface and hashes

Evaluate an explicit artifact contract under a named policy and explain why publication or action is refused. Missing evidence, source, review, and time facts stay explicit rather than being guessed.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Semiotic component name.",
      "type": "string"
    },
    "contract": {
      "additionalProperties": {},
      "description": "Complete explicit artifact contract. Validate against semiotic://artifact-contract-schema; omitted source, review, and time facts stay omitted or explicitly unknown.",
      "properties": {
        "artifact": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "claims": {
          "items": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "contractVersion": {
          "type": "string"
        },
        "evidence": {
          "items": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "purpose": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        }
      },
      "required": [
        "contractVersion",
        "artifact",
        "purpose",
        "claims",
        "evidence"
      ],
      "type": "object"
    },
    "data": {
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "maxItems": 10000,
      "type": "array"
    },
    "exceptions": {
      "items": {
        "additionalProperties": false,
        "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
        "properties": {
          "expiresAt": {
            "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
            "maxLength": 64,
            "type": "string"
          },
          "owner": {
            "maxLength": 240,
            "minLength": 1,
            "type": "string"
          },
          "rationale": {
            "maxLength": 1200,
            "minLength": 1,
            "type": "string"
          },
          "reviewAt": {
            "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
            "maxLength": 64,
            "type": "string"
          },
          "rule": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "rule",
          "rationale",
          "owner"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "type": "array"
    },
    "now": {
      "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
      "maxLength": 64,
      "type": "string"
    },
    "policyId": {
      "description": "Explicit built-in policy identifier used for this operation.",
      "enum": [
        "exploratory",
        "operational-streaming",
        "editorial",
        "public-civic",
        "agent-generated"
      ],
      "type": "string"
    },
    "props": {
      "additionalProperties": {},
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    }
  },
  "required": [
    "component",
    "contract",
    "policyId"
  ],
  "type": "object"
}
sha256:4b3935da83d9f7bcb2a0f6506b6e1791d33ad5e0363bd8b9a2367f7d4cf6f37e

Output schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "contractValidation": {
      "additionalProperties": false,
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "message": {
                "type": "string"
              },
              "path": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "message"
            ],
            "type": "object"
          },
          "maxItems": 25,
          "type": "array"
        },
        "valid": {
          "type": "boolean"
        },
        "warnings": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "message": {
                "type": "string"
              },
              "path": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "message"
            ],
            "type": "object"
          },
          "maxItems": 25,
          "type": "array"
        }
      },
      "required": [
        "valid",
        "errors",
        "warnings"
      ],
      "type": "object"
    },
    "evaluationStatus": {
      "enum": [
        "acceptable",
        "conditional",
        "refuse"
      ],
      "type": "string"
    },
    "explanation": {
      "type": "string"
    },
    "failures": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "evidenceIds": {
            "items": {
              "type": "string"
            },
            "maxItems": 25,
            "type": "array"
          },
          "id": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "relation": {
            "enum": [
              "claim-support",
              "representation-fit",
              "reception",
              "time",
              "challenge-and-correction",
              "accountability",
              "abstention",
              "preservation"
            ],
            "type": "string"
          },
          "repair": {
            "type": "string"
          },
          "status": {
            "enum": [
              "pass",
              "fail",
              "warn",
              "manual",
              "unknown",
              "not-applicable"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "relation",
          "status",
          "message"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "type": "array"
    },
    "policy": {
      "additionalProperties": false,
      "properties": {
        "appliedExceptions": {
          "items": {
            "additionalProperties": false,
            "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
            "properties": {
              "expiresAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "owner": {
                "maxLength": 240,
                "minLength": 1,
                "type": "string"
              },
              "rationale": {
                "maxLength": 1200,
                "minLength": 1,
                "type": "string"
              },
              "reviewAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "rule": {
                "maxLength": 120,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "rule",
              "rationale",
              "owner"
            ],
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "id": {
          "type": "string"
        },
        "rejectedExceptions": {
          "items": {
            "additionalProperties": false,
            "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
            "properties": {
              "expiresAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "owner": {
                "maxLength": 240,
                "minLength": 1,
                "type": "string"
              },
              "rationale": {
                "maxLength": 1200,
                "minLength": 1,
                "type": "string"
              },
              "reviewAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "rule": {
                "maxLength": 120,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "rule",
              "rationale",
              "owner"
            ],
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "version": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "version"
      ],
      "type": "object"
    },
    "repairs": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string"
          },
          "category": {
            "enum": [
              "identity",
              "configuration",
              "contract"
            ],
            "type": "string"
          },
          "changesClaim": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "action",
          "reason",
          "changesClaim"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "type": "array"
    },
    "status": {
      "enum": [
        "refuse",
        "not-refused",
        "invalid-contract"
      ],
      "type": "string"
    },
    "surfaceVersion": {
      "type": "string"
    },
    "truncated": {
      "additionalProperties": false,
      "properties": {
        "explanation": {
          "type": "boolean"
        },
        "failures": {
          "type": "boolean"
        },
        "repairs": {
          "type": "boolean"
        }
      },
      "required": [
        "failures",
        "repairs",
        "explanation"
      ],
      "type": "object"
    }
  },
  "required": [
    "status",
    "policy",
    "contractValidation",
    "surfaceVersion"
  ],
  "type": "object"
}
sha256:3940e98ad407fc624537cf65735268452abd597f26e9a99784570fe206aa294c

Description hash: sha256:31d8320b910bf0df6e4ad1775cc1b5c6620f5bcf989ef7ee5e830fbd84a834fa

Interface hash: sha256:ccda36f593e2ef74a104dba940d043655f2914b274e1034849f71ae2ada79d93

Other observed Modelara metadata
{
  "id": "mcp:semiotic/explainRefusal",
  "title": "Explain an artifact policy refusal",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "explainRefusal"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:3325de8500793ad1a75e5df6c2f483aa60231a379cf9b0137bab544350c3757c"
}
toolread3.13.1No change observed
getSchemanteract-semiotic:tool:getSchema
Observed interface and hashes

Return the prop schema for a Semiotic chart component. Pass { component: '<name>' } to get its props, or omit component to list all available components. Components marked [renderable] can be passed to renderChart for static SVG output.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Component name, e.g. 'LineChart'. Omit to list all.",
      "type": "string"
    }
  },
  "type": "object"
}
sha256:452f4d8f628352054441131414fd63963c3cbbdd664b1cd17898e37caa264b7c

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:8ba601860ef98a14da989274668196630d06aa6690dbbbf8f10f9b927c64d469

Interface hash: sha256:5eaa1c71466eca28f5c9c5dd55e36c0c26120af2f71b815c25290f5b722e6f83

Other observed Modelara metadata
{
  "id": "mcp:semiotic/getSchema",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "getSchema"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:860ac611a0163f9f48fc0e7e5db0707ec8338eee99968d92db21f949570afe34"
}
toolread3.13.1No change observed
groundChartnteract-semiotic:tool:groundChart
Observed interface and hashes

Build the agent-reader grounding payload for a Semiotic chart: the layered L1–L3 natural-language description, the L4 communicative-act sentence (what the chart is asking the reader to do), and a structured navigation tree (chart → axes/series → datum). Use this to interpret a chart faithfully without pixels.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Chart component name, e.g. 'LineChart'",
      "type": "string"
    },
    "props": {
      "additionalProperties": {},
      "description": "The full chart props including data",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    }
  },
  "required": [
    "component",
    "props"
  ],
  "type": "object"
}
sha256:7536b60f402ccdae936ee673c34d2389936afd5c53980b0f55f8c6f50c7250c8

Output schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "component": {
      "type": "string"
    },
    "description": {
      "additionalProperties": {},
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "intent": {
      "additionalProperties": {},
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "physics": {
      "additionalProperties": {},
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "structure": {
      "additionalProperties": {},
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "text": {
      "type": "string"
    }
  },
  "required": [
    "component",
    "description",
    "text"
  ],
  "type": "object"
}
sha256:5e277ce5404fe6d351c80d8809acc20b587f847a15ad15a2efd2920ae1a156c6

Description hash: sha256:2ce9dbf22ac8d60098e50844651191e12c505d2a4342511f5ebf53eadd9d62cd

Interface hash: sha256:73b96133c0de61351e232c77fcc675d35fa4345cf2c77d4b95b7af81762e8fa1

Other observed Modelara metadata
{
  "id": "mcp:semiotic/groundChart",
  "title": "Ground a Semiotic chart for a non-visual reader",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "groundChart"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:92261910bbdcee2feafa13a45b474c20985298aa38e3157d94cac7910295ccb7"
}
toolread3.13.1No change observed
interrogateChartnteract-semiotic:tool:interrogateChart
Observed interface and hashes

Conversational interrogation of a Semiotic chart. Extract a statistical summary and answer natural language questions about the data, trends, and outliers. Returns a summary and guidance for an AI to generate a textual answer and visual annotations.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Chart component name, e.g. 'LineChart'",
      "type": "string"
    },
    "props": {
      "additionalProperties": {},
      "description": "The full chart props including data",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "query": {
      "description": "A natural language question about the chart data",
      "type": "string"
    }
  },
  "required": [
    "component",
    "props"
  ],
  "type": "object"
}
sha256:2dd48d9853d41bd182f2f0070fe9527b41d15b1ee2ed6ae6915fb9b0188d7a69

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:adf756084a20ee7f2e399bdb281733f7f048e59e2a28c5a51cbf44f1bdd09a6c

Interface hash: sha256:1c69e44f666ff05af39c5015fc18b2768782d4104feda9ccd822f498e2c1949e

Other observed Modelara metadata
{
  "id": "mcp:semiotic/interrogateChart",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "interrogateChart"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:baa22673883fe35c8ede58954a577a3a01d3127f2c5720e9cba5eb5eb25644c1"
}
toolread3.13.1No change observed
proposeChartVariantsnteract-semiotic:tool:proposeChartVariants
Observed interface and hashes

Propose and score chart variants for a selected Semiotic component. Uses the capability registry plus heuristic variant discovery: registered variants, conservative transforms, and same-intent cross-family alternatives. Returns ranked proposals with fit/novelty/risk scores, rationale, and ready-to-use props. Use after suggestCharts when an agent wants to actively explore variants rather than stop at the first chart recommendation.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "audience": {
      "description": "Audience profile — familiarity, adoption targets, exposure level, and reception modality.",
      "properties": {
        "exposureLevel": {
          "anyOf": [
            {
              "const": 0,
              "type": "number"
            },
            {
              "const": 1,
              "type": "number"
            },
            {
              "const": 2,
              "type": "number"
            }
          ]
        },
        "familiarity": {
          "additionalProperties": {
            "type": "number"
          },
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "name": {
          "type": "string"
        },
        "receptionModality": {
          "description": "Reception channel — see suggestCharts.",
          "enum": [
            "visual",
            "screen-reader",
            "sonified",
            "agent"
          ],
          "type": "string"
        },
        "targets": {
          "additionalProperties": {
            "properties": {
              "direction": {
                "enum": [
                  "increase",
                  "decrease"
                ],
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "weight": {
                "maximum": 3,
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "direction"
            ],
            "type": "object"
          },
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        }
      },
      "type": "object"
    },
    "component": {
      "description": "Base chart component to vary, e.g. 'LineChart', 'BarChart', or 'BoxPlot'.",
      "type": "string"
    },
    "data": {
      "description": "Row data to profile. Overrides props.data when present.",
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "type": "array"
    },
    "fieldRoles": {
      "additionalProperties": {
        "anyOf": [
          {
            "enum": [
              "identifier",
              "measure",
              "dimension",
              "temporal",
              "x",
              "y",
              "size",
              "category",
              "series",
              "time",
              "ignore"
            ],
            "type": "string"
          },
          {
            "items": {
              "enum": [
                "identifier",
                "measure",
                "dimension",
                "temporal",
                "x",
                "y",
                "size",
                "category",
                "series",
                "time",
                "ignore"
              ],
              "type": "string"
            },
            "type": "array"
          }
        ]
      },
      "description": "Per-field semantic or exact encoding-role hints used before chart ranking.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "identifiers": {
      "description": "Fields that identify records and must not be used as visual encodings or measures.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Ranking intent(s), e.g. trend, distribution, rank, compare-categories, composition-over-time."
    },
    "maxResults": {
      "description": "Cap on proposals returned (default 8).",
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "props": {
      "additionalProperties": {},
      "description": "Existing chart props. If props.data is present it is profiled; network/hierarchy/geo object data can be passed here as raw input.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    }
  },
  "required": [
    "component"
  ],
  "type": "object"
}
sha256:d3d681ce8bc92934a195c7ca926a902bccf57edbb53d27173e7294d20724f27e

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:660a0d0f9cc16f4437529efbecfb91aa6eedde971ca1ac25e47d7c6958ab57cb

Interface hash: sha256:27a45e73c996d72fbdfaaae72ebb83672f70cba839090b5ac044cc2cd42ddef7

Other observed Modelara metadata
{
  "id": "mcp:semiotic/proposeChartVariants",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "proposeChartVariants"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:af5cdf96be7e3e3404bf818fe278aee29801e17fea0559e6c28edcbcf3d5ecd4"
}
toolread3.13.1No change observed
recommendRepresentationnteract-semiotic:tool:recommendRepresentation
Observed interface and hashes

Recommend chart and non-chart outcomes from explicit data and an explicit artifact contract. Evidence, source, review, and time facts are never synthesized. The named policy can recommend waiting, collecting data, or making no claim instead of forcing a chart.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "contract": {
      "additionalProperties": {},
      "description": "Complete explicit artifact contract. Validate against semiotic://artifact-contract-schema; omitted source, review, and time facts stay omitted or explicitly unknown.",
      "properties": {
        "artifact": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "claims": {
          "items": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "contractVersion": {
          "type": "string"
        },
        "evidence": {
          "items": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "purpose": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        }
      },
      "required": [
        "contractVersion",
        "artifact",
        "purpose",
        "claims",
        "evidence"
      ],
      "type": "object"
    },
    "data": {
      "description": "Explicit row data; omit only when contract evidence is sufficient.",
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "maxItems": 10000,
      "type": "array"
    },
    "exceptions": {
      "items": {
        "additionalProperties": false,
        "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
        "properties": {
          "expiresAt": {
            "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
            "maxLength": 64,
            "type": "string"
          },
          "owner": {
            "maxLength": 240,
            "minLength": 1,
            "type": "string"
          },
          "rationale": {
            "maxLength": 1200,
            "minLength": 1,
            "type": "string"
          },
          "reviewAt": {
            "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
            "maxLength": 64,
            "type": "string"
          },
          "rule": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "rule",
          "rationale",
          "owner"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "type": "array"
    },
    "identifiers": {
      "items": {
        "type": "string"
      },
      "maxItems": 64,
      "type": "array"
    },
    "intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "maxItems": 12,
          "type": "array"
        }
      ]
    },
    "maxChartCandidates": {
      "maximum": 8,
      "minimum": 1,
      "type": "integer"
    },
    "now": {
      "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
      "maxLength": 64,
      "type": "string"
    },
    "policyId": {
      "description": "Explicit built-in policy identifier used for this operation.",
      "enum": [
        "exploratory",
        "operational-streaming",
        "editorial",
        "public-civic",
        "agent-generated"
      ],
      "type": "string"
    },
    "preferredComponent": {
      "description": "Optional Semiotic component preference.",
      "maxLength": 120,
      "type": "string"
    }
  },
  "required": [
    "contract",
    "policyId"
  ],
  "type": "object"
}
sha256:7475daeeeb057627110289a4382a7808fbacfee61d050bf4cfbaf5228e63ddc5

Output schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "alternatives": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "caveats": {
            "items": {
              "type": "string"
            },
            "maxItems": 8,
            "type": "array"
          },
          "component": {
            "type": "string"
          },
          "id": {
            "maxLength": 240,
            "type": "string"
          },
          "kind": {
            "enum": [
              "chart",
              "custom-recipe",
              "table",
              "text",
              "small-multiples",
              "collect-more-data",
              "wait-for-settlement",
              "no-comparison",
              "no-claim",
              "no-action"
            ],
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "props": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 8,
            "type": "array"
          },
          "score": {
            "type": "number"
          }
        },
        "required": [
          "id",
          "kind",
          "label",
          "reasons"
        ],
        "type": "object"
      },
      "maxItems": 8,
      "type": "array"
    },
    "contractValidation": {
      "additionalProperties": false,
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "message": {
                "type": "string"
              },
              "path": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "message"
            ],
            "type": "object"
          },
          "maxItems": 25,
          "type": "array"
        },
        "valid": {
          "type": "boolean"
        },
        "warnings": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "message": {
                "type": "string"
              },
              "path": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "message"
            ],
            "type": "object"
          },
          "maxItems": 25,
          "type": "array"
        }
      },
      "required": [
        "valid",
        "errors",
        "warnings"
      ],
      "type": "object"
    },
    "policy": {
      "additionalProperties": false,
      "properties": {
        "appliedExceptions": {
          "items": {
            "additionalProperties": false,
            "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
            "properties": {
              "expiresAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "owner": {
                "maxLength": 240,
                "minLength": 1,
                "type": "string"
              },
              "rationale": {
                "maxLength": 1200,
                "minLength": 1,
                "type": "string"
              },
              "reviewAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "rule": {
                "maxLength": 120,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "rule",
              "rationale",
              "owner"
            ],
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "id": {
          "type": "string"
        },
        "rejectedExceptions": {
          "items": {
            "additionalProperties": false,
            "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
            "properties": {
              "expiresAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "owner": {
                "maxLength": 240,
                "minLength": 1,
                "type": "string"
              },
              "rationale": {
                "maxLength": 1200,
                "minLength": 1,
                "type": "string"
              },
              "reviewAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "rule": {
                "maxLength": 120,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "rule",
              "rationale",
              "owner"
            ],
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "version": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "version"
      ],
      "type": "object"
    },
    "reasons": {
      "items": {
        "type": "string"
      },
      "maxItems": 12,
      "type": "array"
    },
    "rejected": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "caveats": {
            "items": {
              "type": "string"
            },
            "maxItems": 8,
            "type": "array"
          },
          "component": {
            "type": "string"
          },
          "id": {
            "maxLength": 240,
            "type": "string"
          },
          "kind": {
            "enum": [
              "chart",
              "custom-recipe",
              "table",
              "text",
              "small-multiples",
              "collect-more-data",
              "wait-for-settlement",
              "no-comparison",
              "no-claim",
              "no-action"
            ],
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "props": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "reasons": {
            "items": {
              "type": "string"
            },
            "maxItems": 8,
            "type": "array"
          },
          "rejectedBecause": {
            "type": "string"
          },
          "score": {
            "type": "number"
          }
        },
        "required": [
          "id",
          "kind",
          "label",
          "reasons",
          "rejectedBecause"
        ],
        "type": "object"
      },
      "maxItems": 8,
      "type": "array"
    },
    "selected": {
      "additionalProperties": false,
      "properties": {
        "caveats": {
          "items": {
            "type": "string"
          },
          "maxItems": 8,
          "type": "array"
        },
        "component": {
          "type": "string"
        },
        "id": {
          "maxLength": 240,
          "type": "string"
        },
        "kind": {
          "enum": [
            "chart",
            "custom-recipe",
            "table",
            "text",
            "small-multiples",
            "collect-more-data",
            "wait-for-settlement",
            "no-comparison",
            "no-claim",
            "no-action"
          ],
          "type": "string"
        },
        "label": {
          "type": "string"
        },
        "props": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "reasons": {
          "items": {
            "type": "string"
          },
          "maxItems": 8,
          "type": "array"
        },
        "score": {
          "type": "number"
        }
      },
      "required": [
        "id",
        "kind",
        "label",
        "reasons"
      ],
      "type": "object"
    },
    "status": {
      "enum": [
        "recommended",
        "conditional",
        "refuse",
        "invalid-contract"
      ],
      "type": "string"
    },
    "surfaceVersion": {
      "type": "string"
    },
    "truncated": {
      "additionalProperties": false,
      "properties": {
        "alternatives": {
          "type": "boolean"
        },
        "reasons": {
          "type": "boolean"
        },
        "rejected": {
          "type": "boolean"
        }
      },
      "required": [
        "alternatives",
        "rejected",
        "reasons"
      ],
      "type": "object"
    }
  },
  "required": [
    "status",
    "policy",
    "contractValidation",
    "surfaceVersion"
  ],
  "type": "object"
}
sha256:969b676dd8002b520d36418681690e1b3ff3f51299a0858c8abf5506677fa908

Description hash: sha256:15ebaf8ce3440bc4bf85f3680f6318f6d459a19bf381368cd3deccaf0c8932d7

Interface hash: sha256:e45e710bcc7c41e7b8b2c42b7636ebe5e559f93e9f693fb9c8baae21263a0fab

Other observed Modelara metadata
{
  "id": "mcp:semiotic/recommendRepresentation",
  "title": "Recommend a defensible representation",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "recommendRepresentation"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:095596fb2468c944b23a9fa78686a384be78c43f36dab91059775da48adfdc52"
}
toolread3.13.1No change observed
renderChartnteract-semiotic:tool:renderChart
Observed interface and hashes

Render a Semiotic chart to static SVG or PNG. This is a static snapshot path: props must include data immediately, and ref/push-mode charts cannot be rendered through this tool. Returns SVG text by default or an image/png artifact when format='png', plus a "Render evidence" JSON block (mark counts by type, resolved axis domains, empty flag, annotation count, accessible name) — read the evidence instead of parsing the SVG to verify the chart actually rendered data marks. An optional explicit contract is preserved in render evidence together with its transfer status; missing contract facts are not inferred. Optionally pass theme CSS custom properties (--semiotic-bg, --semiotic-text, etc.) to style the output. PNG requires the 'sharp' package to be installed. Available components: AreaChart, BarChart, BigNumber, BoxPlot, BubbleChart, BumpChart, CalendarHeatmapRecipe, CandlestickChart, ChainReactionChart, ChordDiagram, ChoroplethMap, CirclePack, CollisionSwarmChart, ConnectedScatterplot, CrucibleChart, DependencyForestChart, DifferenceChart, DistanceCartogram, DonutChart, DotPlot, EventDropChart, FlowCircuitChart, FlowMap, ForceDirectedGraph, FunnelChart, GaltonBoardChart, GaugeChart, GauntletChart, GroupedBarChart, Heatmap, Histogram, LikertChart, LineChart, MinimapChart, MotifBraidChart, MultiAxisLineChart, OrbitDiagram, PacketFlowChart, ParallelCoordinatesRecipe, PieChart, ProcessFlowChart, ProcessSankey, ProportionalSymbolMap, QuadrantChart, RadarChart, RidgelinePlot, SankeyDiagram, Scatterplot, ScatterplotMatrix, StackedAreaChart, StackedBarChart, SwarmPlot, SwimlaneChart, TemporalHistogram, TreeDiagram, Treemap, UnitPileChart, ViolinPlot, WaterfallChart.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Chart component name, e.g. 'LineChart', 'BarChart'",
      "type": "string"
    },
    "contract": {
      "additionalProperties": {},
      "description": "Optional explicit artifact contract. The render evidence reports whether it was preserved, invalid, or an unsupported version.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "format": {
      "description": "Output format: 'svg' (default) returns SVG markup, 'png' returns image/png artifact data. PNG requires the 'sharp' package.",
      "enum": [
        "svg",
        "png"
      ],
      "type": "string"
    },
    "props": {
      "additionalProperties": {},
      "description": "Chart props object, e.g. { data: [...], xAccessor: 'x' }.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "theme": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "CSS custom properties for theming, e.g. { '--semiotic-bg': '#1a1a2e', '--semiotic-text': '#ededed' }. Only --semiotic-* variables are applied.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    }
  },
  "required": [
    "component"
  ],
  "type": "object"
}
sha256:b2ff8fb2f882b7d3db392c4809440d2e3e140ffcaee0af6bf77bdfc03ac2f335

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:21d7381ebb3b8b54c5b747cb5a7d8228ea4a6a9afec63b85c345581239e5e39a

Interface hash: sha256:6d2d6cdf90d50089390b17ab0daf0d058aae45293ecc3ebf718d8a76adcdc7f3

Other observed Modelara metadata
{
  "id": "mcp:semiotic/renderChart",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "renderChart"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:0dbfa18b531668a929b2fef5aaaede5e2364b5ca746e82c717cfec978338b8ed"
}
toolread3.13.1No change observed
renderInteractiveChartnteract-semiotic:tool:renderInteractiveChart
Observed interface and hashes

Render a static-data Semiotic chart as a ChatGPT Apps widget. Use this after suggestCharts/getSchema/diagnoseConfig when the user wants to see an interactive chart inside ChatGPT. The server renders Semiotic to SVG and the widget adds fit, zoom, data, hover, and render-evidence controls. Available components: AreaChart, BarChart, BigNumber, BoxPlot, BubbleChart, BumpChart, CalendarHeatmapRecipe, CandlestickChart, ChainReactionChart, ChordDiagram, ChoroplethMap, CirclePack, CollisionSwarmChart, ConnectedScatterplot, CrucibleChart, DependencyForestChart, DifferenceChart, DistanceCartogram, DonutChart, DotPlot, EventDropChart, FlowCircuitChart, FlowMap, ForceDirectedGraph, FunnelChart, GaltonBoardChart, GaugeChart, GauntletChart, GroupedBarChart, Heatmap, Histogram, LikertChart, LineChart, MinimapChart, MotifBraidChart, MultiAxisLineChart, OrbitDiagram, PacketFlowChart, ParallelCoordinatesRecipe, PieChart, ProcessFlowChart, ProcessSankey, ProportionalSymbolMap, QuadrantChart, RadarChart, RidgelinePlot, SankeyDiagram, Scatterplot, ScatterplotMatrix, StackedAreaChart, StackedBarChart, SwarmPlot, SwimlaneChart, TemporalHistogram, TreeDiagram, Treemap, UnitPileChart, ViolinPlot, WaterfallChart.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Renderable chart component name, e.g. 'LineChart', 'BarChart', 'GaugeChart'.",
      "type": "string"
    },
    "props": {
      "additionalProperties": {},
      "description": "Static Semiotic chart props, including data/accessors where required.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "theme": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "CSS custom properties such as { '--semiotic-bg': '#fff', '--semiotic-text': '#111' }. Only --semiotic-* variables are applied.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    }
  },
  "required": [
    "component"
  ],
  "type": "object"
}
sha256:1ee3d4cd64c3617cf66d231c47b83795cbb24ece02e36992fb50f5b345ad6890

Output schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "component": {
      "type": "string"
    },
    "datumCount": {
      "type": [
        "number",
        "null"
      ]
    },
    "evidence": {
      "anyOf": [
        {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "summary": {
      "type": "string"
    },
    "title": {
      "type": "string"
    }
  },
  "required": [
    "component",
    "title",
    "summary",
    "datumCount",
    "evidence"
  ],
  "type": "object"
}
sha256:0d214b6d0553200d7b31962dff71814b4d9d72a39292262ea24a42da6540b4a8

Description hash: sha256:0b88d9291da20a64d015c4e6727ecc87c296098b12cfa8de7148086b0c83901d

Interface hash: sha256:9ec86dce5bf76676e628fe34e3e562fc317d05ed73571f470c2fa8c4bf6a8900

Other observed Modelara metadata
{
  "id": "mcp:semiotic/renderInteractiveChart",
  "title": "Render interactive Semiotic chart",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "renderInteractiveChart"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:16075fb7b7a003d6380370b21d5c16e45f2682f7c614c8e949c70002eecda703"
}
toolread3.13.1No change observed
repairArtifactnteract-semiotic:tool:repairArtifact
Observed interface and hashes

Propose repairs for a chart and explicit artifact contract. By default this is proposal-only. If enabled, safe application fills missing component and configuration/data identity fields only; existing bindings are never overwritten. Mismatches require an explicit revision and claim reassessment. Source, evidence, review, approval, and time facts are never invented. Returned contracts omit evidence samples, report transfer losses, and are withheld above a 64 KiB UTF-8 cap.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "applySafeIdentityRepairs": {
      "description": "Fill missing identity fields only; existing mismatches require an explicit revision and claim reassessment. Defaults to false.",
      "type": "boolean"
    },
    "component": {
      "description": "Semiotic component name.",
      "type": "string"
    },
    "contract": {
      "additionalProperties": {},
      "description": "Complete explicit artifact contract. Validate against semiotic://artifact-contract-schema; omitted source, review, and time facts stay omitted or explicitly unknown.",
      "properties": {
        "artifact": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "claims": {
          "items": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "contractVersion": {
          "type": "string"
        },
        "evidence": {
          "items": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "purpose": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        }
      },
      "required": [
        "contractVersion",
        "artifact",
        "purpose",
        "claims",
        "evidence"
      ],
      "type": "object"
    },
    "data": {
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "maxItems": 10000,
      "type": "array"
    },
    "exceptions": {
      "items": {
        "additionalProperties": false,
        "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
        "properties": {
          "expiresAt": {
            "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
            "maxLength": 64,
            "type": "string"
          },
          "owner": {
            "maxLength": 240,
            "minLength": 1,
            "type": "string"
          },
          "rationale": {
            "maxLength": 1200,
            "minLength": 1,
            "type": "string"
          },
          "reviewAt": {
            "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
            "maxLength": 64,
            "type": "string"
          },
          "rule": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "rule",
          "rationale",
          "owner"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "type": "array"
    },
    "now": {
      "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
      "maxLength": 64,
      "type": "string"
    },
    "policyId": {
      "description": "Explicit built-in policy identifier used for this operation.",
      "enum": [
        "exploratory",
        "operational-streaming",
        "editorial",
        "public-civic",
        "agent-generated"
      ],
      "type": "string"
    },
    "props": {
      "additionalProperties": {},
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    }
  },
  "required": [
    "component",
    "contract",
    "policyId"
  ],
  "type": "object"
}
sha256:278e4583101bb2c43da2727e69b2ecb0170b9a44c9cb30500d7b6c3c9d258c57

Output schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "afterStatus": {
      "enum": [
        "acceptable",
        "conditional",
        "refuse"
      ],
      "type": "string"
    },
    "beforeStatus": {
      "enum": [
        "acceptable",
        "conditional",
        "refuse"
      ],
      "type": "string"
    },
    "contract": {
      "additionalProperties": {},
      "description": "Complete explicit artifact contract. Validate against semiotic://artifact-contract-schema; omitted source, review, and time facts stay omitted or explicitly unknown.",
      "properties": {
        "artifact": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "claims": {
          "items": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "contractVersion": {
          "type": "string"
        },
        "evidence": {
          "items": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "array"
        },
        "purpose": {
          "additionalProperties": {},
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        }
      },
      "required": [
        "contractVersion",
        "artifact",
        "purpose",
        "claims",
        "evidence"
      ],
      "type": "object"
    },
    "contractTransfer": {
      "additionalProperties": false,
      "properties": {
        "format": {
          "type": "string"
        },
        "omittedPaths": {
          "items": {
            "type": "string"
          },
          "maxItems": 25,
          "type": "array"
        },
        "preservation": {
          "enum": [
            "full-fidelity",
            "claim-evidence-preserved",
            "visual-only",
            "lossy",
            "unknown"
          ],
          "type": "string"
        },
        "preservedPaths": {
          "items": {
            "type": "string"
          },
          "maxItems": 25,
          "type": "array"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "maxItems": 25,
          "type": "array"
        }
      },
      "required": [
        "format",
        "preservation",
        "preservedPaths",
        "omittedPaths",
        "warnings"
      ],
      "type": "object"
    },
    "contractValidation": {
      "additionalProperties": false,
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "message": {
                "type": "string"
              },
              "path": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "message"
            ],
            "type": "object"
          },
          "maxItems": 25,
          "type": "array"
        },
        "valid": {
          "type": "boolean"
        },
        "warnings": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "message": {
                "type": "string"
              },
              "path": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "message"
            ],
            "type": "object"
          },
          "maxItems": 25,
          "type": "array"
        }
      },
      "required": [
        "valid",
        "errors",
        "warnings"
      ],
      "type": "object"
    },
    "ledger": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string"
          },
          "applied": {
            "type": "boolean"
          },
          "category": {
            "enum": [
              "identity",
              "configuration",
              "contract"
            ],
            "type": "string"
          },
          "changesClaim": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "suggestedComponent": {
            "type": "string"
          },
          "suggestedVariant": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "path",
          "action",
          "reason",
          "applied",
          "changesClaim"
        ],
        "type": "object"
      },
      "maxItems": 50,
      "type": "array"
    },
    "policy": {
      "additionalProperties": false,
      "properties": {
        "appliedExceptions": {
          "items": {
            "additionalProperties": false,
            "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
            "properties": {
              "expiresAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "owner": {
                "maxLength": 240,
                "minLength": 1,
                "type": "string"
              },
              "rationale": {
                "maxLength": 1200,
                "minLength": 1,
                "type": "string"
              },
              "reviewAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "rule": {
                "maxLength": 120,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "rule",
              "rationale",
              "owner"
            ],
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "id": {
          "type": "string"
        },
        "rejectedExceptions": {
          "items": {
            "additionalProperties": false,
            "description": "Accountable policy exception. It applies only when a supplied expiry or review bound remains in the future at the explicit reference clock.",
            "properties": {
              "expiresAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "owner": {
                "maxLength": 240,
                "minLength": 1,
                "type": "string"
              },
              "rationale": {
                "maxLength": 1200,
                "minLength": 1,
                "type": "string"
              },
              "reviewAt": {
                "description": "Explicit reference clock for review, freshness, and expiry checks. Use an ISO 8601 timestamp.",
                "maxLength": 64,
                "type": "string"
              },
              "rule": {
                "maxLength": 120,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "rule",
              "rationale",
              "owner"
            ],
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "version": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "version"
      ],
      "type": "object"
    },
    "status": {
      "enum": [
        "unchanged",
        "repaired",
        "requires-input",
        "invalid-contract"
      ],
      "type": "string"
    },
    "surfaceVersion": {
      "type": "string"
    },
    "truncated": {
      "additionalProperties": false,
      "properties": {
        "contract": {
          "type": "boolean"
        },
        "ledger": {
          "type": "boolean"
        },
        "transfer": {
          "type": "boolean"
        }
      },
      "required": [
        "ledger",
        "contract",
        "transfer"
      ],
      "type": "object"
    }
  },
  "required": [
    "status",
    "policy",
    "contractValidation",
    "surfaceVersion"
  ],
  "type": "object"
}
sha256:132ae681b1af0357051b4739e2617411eae536ee7af98644fd267c6364c4ffc8

Description hash: sha256:41573f9392c84cbe2919ff0f60aacf7c310cf5213ed099d47c898988c12eab51

Interface hash: sha256:7bb9ed686e4aab07cea9e975e82d1b374388b033aebbe8a25fddb4ff9c22aecb

Other observed Modelara metadata
{
  "id": "mcp:semiotic/repairArtifact",
  "title": "Repair an explicit artifact contract",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "repairArtifact"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:ae54f52046ca3f4c20b00613f5e71e0bf5f3392bc37f696af48e742617457955"
}
toolread3.13.1No change observed
repairChartConfignteract-semiotic:tool:repairChartConfig
Observed interface and hashes

Validate that a chart component is a sensible choice for a dataset, and if not, propose ranked alternatives that fit. Returns a structured status of ok, alternative, or unknown.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "component": {
      "description": "Chart component name to validate, e.g. 'PieChart'",
      "type": "string"
    },
    "data": {
      "description": "Row data — array of objects.",
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "type": "array"
    },
    "fieldRoles": {
      "additionalProperties": {
        "anyOf": [
          {
            "enum": [
              "identifier",
              "measure",
              "dimension",
              "temporal",
              "x",
              "y",
              "size",
              "category",
              "series",
              "time",
              "ignore"
            ],
            "type": "string"
          },
          {
            "items": {
              "enum": [
                "identifier",
                "measure",
                "dimension",
                "temporal",
                "x",
                "y",
                "size",
                "category",
                "series",
                "time",
                "ignore"
              ],
              "type": "string"
            },
            "type": "array"
          }
        ]
      },
      "description": "Per-field semantic or exact encoding-role hints used before chart ranking.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "identifiers": {
      "description": "Fields that identify records and must not be used as visual encodings or measures.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "User intent — informs ranking of alternatives when the chart doesn't fit."
    },
    "maxAlternatives": {
      "description": "Cap on alternatives returned (default 3).",
      "maximum": 10,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "component",
    "data"
  ],
  "type": "object"
}
sha256:5fc827f921f8a8a961c730cfc0b1f21f528f145b061001802b7e4b2931b99c92

Output schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "alternatives": {
      "items": {},
      "type": "array"
    },
    "component": {
      "type": "string"
    },
    "profile": {
      "additionalProperties": {},
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "reason": {
      "type": "string"
    },
    "repairs": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "status": {
      "enum": [
        "ok",
        "alternative",
        "unknown"
      ],
      "type": "string"
    }
  },
  "required": [
    "status",
    "component",
    "profile"
  ],
  "type": "object"
}
sha256:90940043de964be3791c4f2262a056b8ededaabf97aca2c3d8ad7a07c482d373

Description hash: sha256:7305e2a6aeb7a2eb96bfea8af575b1d13dc1f50d5be9cc91922d83e79e4b0c34

Interface hash: sha256:da161433162ff1c8c6e5a5a6d3b2cb40493623735dd9447b9aad27a42f69549f

Other observed Modelara metadata
{
  "id": "mcp:semiotic/repairChartConfig",
  "title": "Repair an unsuitable chart choice",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "repairChartConfig"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:861325b59b563df3008fe1799af51f67f6f29e9a839a4ede98b8e3fad431988e"
}
toolread3.13.1No change observed
reportIssuenteract-semiotic:tool:reportIssue
Observed interface and hashes

Generate a GitHub issue URL for Semiotic bug reports or feature requests. Returns a URL the user can open to submit. For rendering bugs, include the component name, props summary, and any diagnoseConfig output in the body.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "body": {
      "description": "Issue body with details, reproduction steps, diagnoseConfig output",
      "type": "string"
    },
    "labels": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "string"
        }
      ],
      "description": "GitHub labels, e.g. ['bug'] or 'bug'"
    },
    "title": {
      "description": "Issue title, e.g. 'Bug: BarChart tooltip shows undefined'",
      "type": "string"
    }
  },
  "required": [
    "title"
  ],
  "type": "object"
}
sha256:8c214c807c96cf7d5f9b19a266cc3b30ad61a609b6b60298f71d8c501194aeb0

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:bc2537f4bfdf8abcae552f315ced589dd5a3b91fba1fb83b18454a3e8efc7eb7

Interface hash: sha256:5690002d6a17dc2b6480e07e688fb938bf840e135e515aa86108b3600e304cbf

Other observed Modelara metadata
{
  "id": "mcp:semiotic/reportIssue",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "reportIssue"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:eb0ed5f3a87d62a94a1acfb1615223a833f5bdc0487c00f50c7411996d5719b7"
}
toolread3.13.1No change observed
suggestChartnteract-semiotic:tool:suggestChart
Observed interface and hashes

Lightweight heuristic chart recommender for a small data sample (1-5 rows) with capability filtering (push API, linked hover, SSR, selection, legend). Returns ranked recommendations with example props. For richer capability-descriptor ranking (scores, reasons, caveats) and the full 13-intent taxonomy, prefer `suggestCharts` (plural).

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "capabilities": {
      "additionalProperties": false,
      "description": "Capability constraints — set a key to true to require, false to forbid. Unset keys are ignored.",
      "properties": {
        "legend": {
          "description": "Require a top-level legend",
          "type": "boolean"
        },
        "linkedHover": {
          "description": "Require cross-chart linked hover support",
          "type": "boolean"
        },
        "push": {
          "description": "Require ref-based push API (live streaming via ref.current.push())",
          "type": "boolean"
        },
        "selection": {
          "description": "Require named selection / cross-filter support",
          "type": "boolean"
        },
        "ssr": {
          "description": "Require server-side rendering via renderChart()",
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "data": {
      "description": "1-5 sample data objects",
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "maxItems": 5,
      "minItems": 1,
      "type": "array"
    },
    "intent": {
      "description": "Visualization intent. Accepts this engine's intents (comparison, trend, distribution, relationship, composition, geographic, network, hierarchy) AND the richer suggestCharts taxonomy (compare-categories, part-to-whole, correlation, flow, geo, rank, …), which is translated automatically; an unrecognized intent is ignored rather than rejected.",
      "type": "string"
    }
  },
  "required": [
    "data"
  ],
  "type": "object"
}
sha256:a5505fc2c7dbce5c4417ee6fbb6938f098fb068ae71c6b9cd5b4d4f982220256

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:460b0af52cd1e0f4e81b7f20d368c481a34d865cc6ca598aed9eda3f443fad3f

Interface hash: sha256:602f0924155e1c8d19ac3b397bd9112b43e27fcad5ae142e81a8d88c61db8cbe

Other observed Modelara metadata
{
  "id": "mcp:semiotic/suggestChart",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "suggestChart"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:e1752c566ebae1a5212761471f4724ee79120df36e6681e01e9b1e205f965cf7"
}
toolread3.13.1No change observed
suggestChartsnteract-semiotic:tool:suggestCharts
Observed interface and hashes

Recommend Semiotic charts for a dataset using heuristic capability descriptors. Returns ranked, structured suggestions with scores, reasons, caveats, and ready-to-use props; no LLM call is made.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "allow": {
      "description": "Restrict to these component names.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "audience": {
      "description": "Audience profile — familiarity, adoption targets, exposure level, and reception modality.",
      "properties": {
        "exposureLevel": {
          "anyOf": [
            {
              "const": 0,
              "type": "number"
            },
            {
              "const": 1,
              "type": "number"
            },
            {
              "const": 2,
              "type": "number"
            }
          ]
        },
        "familiarity": {
          "additionalProperties": {
            "type": "number"
          },
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "name": {
          "type": "string"
        },
        "receptionModality": {
          "description": "Reception channel. A non-visual value down-ranks charts the audience can't receive in that channel and adds receivability caveats.",
          "enum": [
            "visual",
            "screen-reader",
            "sonified",
            "agent"
          ],
          "type": "string"
        },
        "targets": {
          "additionalProperties": {
            "properties": {
              "direction": {
                "enum": [
                  "increase",
                  "decrease"
                ],
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "weight": {
                "maximum": 3,
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "direction"
            ],
            "type": "object"
          },
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        }
      },
      "type": "object"
    },
    "data": {
      "description": "Row data — array of objects.",
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "type": "array"
    },
    "deny": {
      "description": "Exclude these component names.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "fieldRoles": {
      "additionalProperties": {
        "anyOf": [
          {
            "enum": [
              "identifier",
              "measure",
              "dimension",
              "temporal",
              "x",
              "y",
              "size",
              "category",
              "series",
              "time",
              "ignore"
            ],
            "type": "string"
          },
          {
            "items": {
              "enum": [
                "identifier",
                "measure",
                "dimension",
                "temporal",
                "x",
                "y",
                "size",
                "category",
                "series",
                "time",
                "ignore"
              ],
              "type": "string"
            },
            "type": "array"
          }
        ]
      },
      "description": "Per-field semantic or exact encoding-role hints used before chart ranking.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "identifiers": {
      "description": "Fields that identify records and must not be used as visual encodings or measures.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Ranking intent. One of: trend, compare-series, compare-categories, rank, part-to-whole, distribution, correlation, flow, hierarchy, geo, outlier-detection, composition-over-time, change-detection. Custom intents accepted."
    },
    "maxResults": {
      "description": "Cap on suggestions returned (default 8).",
      "maximum": 40,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "data"
  ],
  "type": "object"
}
sha256:8c12e825c9f9f98a15a08819e9392f00eaa13311cbd6d02a4c21de8d82ad63e0

Output schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "suggestions": {
      "items": {},
      "type": "array"
    }
  },
  "required": [
    "suggestions"
  ],
  "type": "object"
}
sha256:cbb91bddfa23bf428b2fd8b3845c639c0a7674567042f48a55e2c7bef1cf6e97

Description hash: sha256:4b3540ec11c88597501f49f29d2d675911a64d092d5b8105aa24a5bb44b11485

Interface hash: sha256:7f1ce2ae54a20d703e67add67c5dd3f4f0b1c0a6eb3efe8e7a5b9ac19f8bec9c

Other observed Modelara metadata
{
  "id": "mcp:semiotic/suggestCharts",
  "title": "Recommend Semiotic charts",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "suggestCharts"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:7ee6ad284b46726d68196b4449ecdcf7b66652137630f40380598344bfa59c3e"
}
toolread3.13.1No change observed
suggestDashboardnteract-semiotic:tool:suggestDashboard
Observed interface and hashes

Generate a dashboard of complementary chart panels for a dataset — each panel answers a distinct analytical intent (trend, rank, distribution, correlation, etc.) and the engine diversifies by chart family by default. Heuristic only; no LLM call. Use when the user asks 'show me this data' or 'build me a dashboard' rather than picking one chart.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "audience": {
      "description": "Audience profile — familiarity, adoption targets, exposure level, and reception modality.",
      "properties": {
        "exposureLevel": {
          "anyOf": [
            {
              "const": 0,
              "type": "number"
            },
            {
              "const": 1,
              "type": "number"
            },
            {
              "const": 2,
              "type": "number"
            }
          ]
        },
        "familiarity": {
          "additionalProperties": {
            "type": "number"
          },
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "name": {
          "type": "string"
        },
        "receptionModality": {
          "enum": [
            "visual",
            "screen-reader",
            "sonified",
            "agent"
          ],
          "type": "string"
        },
        "targets": {
          "additionalProperties": {
            "properties": {
              "direction": {
                "enum": [
                  "increase",
                  "decrease"
                ],
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "weight": {
                "maximum": 3,
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "direction"
            ],
            "type": "object"
          },
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        }
      },
      "type": "object"
    },
    "data": {
      "description": "Row data — array of objects.",
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "type": "array"
    },
    "diversifyByFamily": {
      "description": "Prefer not to repeat chart families across panels (default true).",
      "type": "boolean"
    },
    "fieldRoles": {
      "additionalProperties": {
        "anyOf": [
          {
            "enum": [
              "identifier",
              "measure",
              "dimension",
              "temporal",
              "x",
              "y",
              "size",
              "category",
              "series",
              "time",
              "ignore"
            ],
            "type": "string"
          },
          {
            "items": {
              "enum": [
                "identifier",
                "measure",
                "dimension",
                "temporal",
                "x",
                "y",
                "size",
                "category",
                "series",
                "time",
                "ignore"
              ],
              "type": "string"
            },
            "type": "array"
          }
        ]
      },
      "description": "Per-field semantic or exact encoding-role hints used before chart ranking.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "identifiers": {
      "description": "Fields that identify records and must not be used as visual encodings or measures.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "intents": {
      "description": "Intents to cover. Omit to let the engine pick based on the data shape.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "maxPanels": {
      "description": "Maximum panels (default 6).",
      "maximum": 12,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "data"
  ],
  "type": "object"
}
sha256:a9890766f643b43471f192e661c9b5a91a507bec54afad0ee18555937318d9fa

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:b0ab651aa80c8cf13356be1d8465204dd9058f7e7ea443df3fec121eeffcfd0d

Interface hash: sha256:9057ab6864acfe18dc96210d2280a816e513ea82a2f3e049d7067fc7c33150c8

Other observed Modelara metadata
{
  "id": "mcp:semiotic/suggestDashboard",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "suggestDashboard"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:772acfa8c6079014590e2e564f06d74b16847953a1655363fb804f51dc689450"
}
toolread3.13.1No change observed
suggestStreamChartsnteract-semiotic:tool:suggestStreamCharts
Observed interface and hashes

Recommend streaming Semiotic charts for a schema (not row data). Pass fields (with optional cardinality and additive hints) plus optional throughput (band or rows/sec), retention, shape ('append'|'keyed'|'aggregate'), and keyFields. Ranks realtime XY charts plus push-capable ordinal/value/xy charts (BarChart, PieChart, Scatterplot, BigNumber, GaugeChart, …). Returns suggestions, excluded fits-reasons, the ranking intents (inferred when none is given), schema warnings, and optional stretch picks when audience is set.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "audience": {
      "additionalProperties": {},
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Ranking intent."
    },
    "maxResults": {
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "schema": {
      "additionalProperties": {},
      "description": "Stream schema — fields plus throughput/retention/shape hints. No row data.",
      "properties": {
        "fields": {
          "items": {
            "additionalProperties": {},
            "properties": {
              "additive": {
                "description": "Whether summing the measure across events is meaningful (counts, amounts, changes) or not (prices, latencies, percentages).",
                "type": "boolean"
              },
              "cardinality": {
                "description": "Expected distinct values for a categorical, boolean, or key field.",
                "minimum": 0,
                "type": "number"
              },
              "kind": {
                "enum": [
                  "numeric",
                  "categorical",
                  "date",
                  "boolean"
                ],
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "enum": [
                  "x",
                  "y",
                  "value",
                  "category",
                  "series",
                  "size",
                  "key"
                ],
                "type": "string"
              }
            },
            "required": [
              "name",
              "kind"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "keyFields": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "retention": {
          "enum": [
            "windowed",
            "cumulative"
          ],
          "type": "string"
        },
        "shape": {
          "enum": [
            "append",
            "keyed",
            "aggregate"
          ],
          "type": "string"
        },
        "throughput": {
          "anyOf": [
            {
              "enum": [
                "low",
                "medium",
                "high"
              ],
              "type": "string"
            },
            {
              "type": "number"
            }
          ]
        }
      },
      "required": [
        "fields"
      ],
      "type": "object"
    }
  },
  "required": [
    "schema"
  ],
  "type": "object"
}
sha256:421efe1f8f571732cd04a1733593a33086a0318fb0850a6658ba3b93f22ed890

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:8af1b4ef980d1860542051e7f9c34be6fe152f36c538c330641556a7bcaf77ef

Interface hash: sha256:0dd62185320d82a3231a34ee7b02b33c6b13e96007e855cd5526a6fa4b31f72a

Other observed Modelara metadata
{
  "id": "mcp:semiotic/suggestStreamCharts",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "suggestStreamCharts"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:369f4167e2affb59fcc0ad6e3b1b6acb460125154f5accd210c49a595050b304"
}
toolread3.13.13.13.3
suggestStreamDashboardnteract-semiotic:tool:suggestStreamDashboard
Observed interface and hashes

Compose a multi-panel dashboard from one or more stream schemas. Honors AudienceProfile.dashboard layout policy (cellBudget, leadFamilies, windowPreference).

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "audience": {
      "additionalProperties": {},
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "budget": {
      "maximum": 12,
      "minimum": 1,
      "type": "integer"
    },
    "intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ]
    },
    "schemas": {
      "anyOf": [
        {
          "additionalProperties": {},
          "properties": {
            "fields": {
              "items": {
                "additionalProperties": {},
                "properties": {
                  "additive": {
                    "description": "Whether summing the measure across events is meaningful (counts, amounts, changes) or not (prices, latencies, percentages).",
                    "type": "boolean"
                  },
                  "cardinality": {
                    "description": "Expected distinct values for a categorical, boolean, or key field.",
                    "minimum": 0,
                    "type": "number"
                  },
                  "kind": {
                    "enum": [
                      "numeric",
                      "categorical",
                      "date",
                      "boolean"
                    ],
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "role": {
                    "enum": [
                      "x",
                      "y",
                      "value",
                      "category",
                      "series",
                      "size",
                      "key"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "kind"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "keyFields": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "retention": {
              "enum": [
                "windowed",
                "cumulative"
              ],
              "type": "string"
            },
            "shape": {
              "enum": [
                "append",
                "keyed",
                "aggregate"
              ],
              "type": "string"
            },
            "throughput": {
              "anyOf": [
                {
                  "enum": [
                    "low",
                    "medium",
                    "high"
                  ],
                  "type": "string"
                },
                {
                  "type": "number"
                }
              ]
            }
          },
          "required": [
            "fields"
          ],
          "type": "object"
        },
        {
          "items": {
            "additionalProperties": {},
            "properties": {
              "fields": {
                "items": {
                  "additionalProperties": {},
                  "properties": {
                    "additive": {
                      "description": "Whether summing the measure across events is meaningful (counts, amounts, changes) or not (prices, latencies, percentages).",
                      "type": "boolean"
                    },
                    "cardinality": {
                      "description": "Expected distinct values for a categorical, boolean, or key field.",
                      "minimum": 0,
                      "type": "number"
                    },
                    "kind": {
                      "enum": [
                        "numeric",
                        "categorical",
                        "date",
                        "boolean"
                      ],
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "role": {
                      "enum": [
                        "x",
                        "y",
                        "value",
                        "category",
                        "series",
                        "size",
                        "key"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "name",
                    "kind"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "keyFields": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "retention": {
                "enum": [
                  "windowed",
                  "cumulative"
                ],
                "type": "string"
              },
              "shape": {
                "enum": [
                  "append",
                  "keyed",
                  "aggregate"
                ],
                "type": "string"
              },
              "throughput": {
                "anyOf": [
                  {
                    "enum": [
                      "low",
                      "medium",
                      "high"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "number"
                  }
                ]
              }
            },
            "required": [
              "fields"
            ],
            "type": "object"
          },
          "minItems": 1,
          "type": "array"
        }
      ]
    }
  },
  "required": [
    "schemas"
  ],
  "type": "object"
}
sha256:41f763bdc5cdbddffd11362af33860885fa332b572cee6b3744dcafdadbf4cd0

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:c86adda5e599226057fd9645ac760e5b2ad88c36197b1d0fcdbe982415d2cfe2

Interface hash: sha256:99ea3fa201752e6364c037cbb6a20bff4f98e2bd8fb201b4add3e500ea58a1fe

Other observed Modelara metadata
{
  "id": "mcp:semiotic/suggestStreamDashboard",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "suggestStreamDashboard"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:52dd0a528c8f853900d8468a40376c1a3bda9df2312029685be1402a3cdb9127"
}
toolread3.13.13.13.3
suggestStretchChartsnteract-semiotic:tool:suggestStretchCharts
Observed interface and hashes

Recommend literacy-growth chart picks for a dataset given an AudienceProfile. Returns charts the data supports but the audience is unfamiliar with (familiarity ≤ 3, or ≤ 4 at exposureLevel 2), each paired with the familiar chart it could substitute for and a rationale. Use when the consumer wants to gently expose users to less familiar but more analytically appropriate visualizations.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "audience": {
      "description": "Audience profile — familiarity, targets, exposure level, reception modality.",
      "properties": {
        "exposureLevel": {
          "anyOf": [
            {
              "const": 0,
              "type": "number"
            },
            {
              "const": 1,
              "type": "number"
            },
            {
              "const": 2,
              "type": "number"
            }
          ]
        },
        "familiarity": {
          "additionalProperties": {
            "type": "number"
          },
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        },
        "name": {
          "type": "string"
        },
        "receptionModality": {
          "description": "Reception channel — see suggestCharts.",
          "enum": [
            "visual",
            "screen-reader",
            "sonified",
            "agent"
          ],
          "type": "string"
        },
        "targets": {
          "additionalProperties": {
            "properties": {
              "direction": {
                "enum": [
                  "increase",
                  "decrease"
                ],
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "weight": {
                "maximum": 3,
                "minimum": 1,
                "type": "integer"
              }
            },
            "required": [
              "direction"
            ],
            "type": "object"
          },
          "propertyNames": {
            "type": "string"
          },
          "type": "object"
        }
      },
      "type": "object"
    },
    "data": {
      "description": "Row data.",
      "items": {
        "additionalProperties": {},
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "type": "array"
    },
    "fieldRoles": {
      "additionalProperties": {
        "anyOf": [
          {
            "enum": [
              "identifier",
              "measure",
              "dimension",
              "temporal",
              "x",
              "y",
              "size",
              "category",
              "series",
              "time",
              "ignore"
            ],
            "type": "string"
          },
          {
            "items": {
              "enum": [
                "identifier",
                "measure",
                "dimension",
                "temporal",
                "x",
                "y",
                "size",
                "category",
                "series",
                "time",
                "ignore"
              ],
              "type": "string"
            },
            "type": "array"
          }
        ]
      },
      "description": "Per-field semantic or exact encoding-role hints used before chart ranking.",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "identifiers": {
      "description": "Fields that identify records and must not be used as visual encodings or measures.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ]
    },
    "maxResults": {
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "data",
    "audience"
  ],
  "type": "object"
}
sha256:cd79262362496e3427e31b9bf8b8219f5abafefbbb5f279f6f90bb49cde19110

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:0525bc803ba92b3008192a57724362e8ce9755fb042c2c1ec65e5911f7ced9b6

Interface hash: sha256:fe6af79c95e32383514c3840d616eaf63f906363d20e6798e3269d53a01a1dd8

Other observed Modelara metadata
{
  "id": "mcp:semiotic/suggestStretchCharts",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "suggestStretchCharts"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:5260aafc8a4387cb69536a2aaf7a83e49f4c7f11945d0cbae7755ecc434ce76a"
}
toolread3.13.1No change observed
suggestTokenEncodingnteract-semiotic:tool:suggestTokenEncoding
Observed interface and hashes

Recommend a semantic token / ISOTYPE encoding for a reader task. Use before drawing repeated dots, icons, glyphs, natural-frequency grids, quantile dotplots, or hybrid bar-token views. Returns the recommended tokenEncoding, warnings, alternatives, and matching suggestCharts capability intents. Accepts canonical token intents (precise-comparison, probability-estimation, risk-communication, memory, support-decision, etc.) and friendly aliases (measure, estimate probability, understand risk, remember, decide).

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "audience": {
      "description": "Audience for the recommendation.",
      "enum": [
        "expert",
        "general-public",
        "internal"
      ],
      "type": "string"
    },
    "availableSpace": {
      "description": "Space budget for visible tokens.",
      "enum": [
        "small",
        "medium",
        "large"
      ],
      "type": "string"
    },
    "concreteEntity": {
      "description": "Concrete icon/glyph concept, e.g. person, bus, server. Becomes tokenEncoding.icon when useful.",
      "type": "string"
    },
    "dataType": {
      "description": "Data shape or meaning behind the tokenized view.",
      "enum": [
        "count",
        "measure",
        "distribution",
        "probability",
        "risk",
        "category"
      ],
      "type": "string"
    },
    "precisionNeed": {
      "description": "How much exact magnitude reading matters.",
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "type": "string"
    },
    "taskIntent": {
      "description": "Reader task intent, e.g. 'estimate probability', 'understand risk', 'remember', 'measure', 'decide', or canonical token intents like 'probability-estimation'.",
      "type": "string"
    }
  },
  "required": [
    "taskIntent"
  ],
  "type": "object"
}
sha256:effe41ae307d9eec09ca8197b13c6e28d9e1a7095c6e1d523dae9258203bc5d2

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:7801602fa0259835c4a695be788daabc4dd15605678b9b6289456388b6bcf96f

Interface hash: sha256:07f8a8f5b8b072188dfe128e0e8cfa9a484260095b7461e4df5239558e6e3b91

Other observed Modelara metadata
{
  "id": "mcp:semiotic/suggestTokenEncoding",
  "source": {
    "type": "mcp",
    "server": "semiotic",
    "operation": "suggestTokenEncoding"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:c7de230f25f5922514d160a0d115534b859fd0f8103ba7fd9ee5732ccdd1d04c"
}
toolread3.13.1No change observed

STATIC COMPARISONS

Release history

2 release transitions
  1. 0 added0 removed2 schema0 write0 destructive0 unknown

    Nov 16, 2026· Pending human review

  2. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 16, 2026· Automated static analysis