Semiotic

Verified React chart generation: select, validate, repair, render, and inspect charts through MCP.

Should I use this

Quality & Safety

A
Description quality
90%
Schema completeness
80%
Naming quality
92%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'getChartSchema' description lacks action verbin getChartSchema

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,756Tokens (tool definitions)
~3.8 KBTypical response size
Moderate attention impact (1.37% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "semiotic": {
      "command": "npx",
      "args": [
        "semiotic"
      ]
    }
  }
}

Runnable packages

npmsemiotic3.10.4stdio

Remote endpoints

https://semiotic-mcp-server-481507046413.us-west1.run.app/mcpstreamable-http

What it can do

Tool inventory

Tools (5)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢createChart(data, intent, audience, identifiers, fieldRoles, ...)

Select, validate, diagnose, render, and prove a static-data Semiotic chart. This is the default public workflow.

Input Schema

{
  "type": "object",
  "properties": {
    "data": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "audience": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "receptionModality": {
          "type": "string",
          "enum": [
            "visual",
            "screen-reader",
            "sonified",
            "agent"
          ]
        }
      },
      "additionalProperties": {}
    },
    "identifiers": {
      "description": "Fields that identify records and must not be used as visual encodings or measures.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fieldRoles": {
      "description": "Per-field semantic or exact encoding-role hints used before chart ranking.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "enum": [
              "identifier",
              "measure",
              "dimension",
              "temporal",
              "x",
              "y",
              "size",
              "category",
              "series",
              "time",
              "ignore"
            ]
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "identifier",
                "measure",
                "dimension",
                "temporal",
                "x",
                "y",
                "size",
                "category",
                "series",
                "time",
                "ignore"
              ]
            }
          }
        ]
      }
    },
    "component": {
      "description": "Optional chart preference; the fit-ranked result remains authoritative.",
      "type": "string"
    },
    "props": {
      "description": "Optional props to merge over the selected chart recipe.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "theme": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "render-proven",
        "blocked",
        "no-suggestion"
      ]
    },
    "component": {
      "type": "string"
    },
    "evidenceEnvelope": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "evidenceGate": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "surfaceVersion": {
      "type": "string"
    }
  },
  "required": [
    "status",
    "surfaceVersion"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢improveChart(component, props, data, intent, identifiers, ...)

Diagnose a chart configuration, assess data fit, and propose repairs or variants.

Input Schema

{
  "type": "object",
  "properties": {
    "component": {
      "type": "string"
    },
    "props": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "identifiers": {
      "description": "Fields that identify records and must not be used as visual encodings or measures.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fieldRoles": {
      "description": "Per-field semantic or exact encoding-role hints used before chart ranking.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "enum": [
              "identifier",
              "measure",
              "dimension",
              "temporal",
              "x",
              "y",
              "size",
              "category",
              "series",
              "time",
              "ignore"
            ]
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "identifier",
                "measure",
                "dimension",
                "temporal",
                "x",
                "y",
                "size",
                "category",
                "series",
                "time",
                "ignore"
              ]
            }
          }
        ]
      }
    }
  },
  "required": [
    "component",
    "props"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "reviewed",
        "repair-needed"
      ]
    },
    "component": {
      "type": "string"
    },
    "diagnostics": {
      "type": "array",
      "items": {}
    },
    "repair": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "variants": {
      "type": "array",
      "items": {}
    },
    "accessibilityRecommendation": {
      "type": "object",
      "properties": {
        "location": {
          "type": "string",
          "const": "direct-component-props"
        },
        "props": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "string"
          }
        },
        "chartContainer": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "location",
        "props",
        "chartContainer"
      ],
      "additionalProperties": false
    },
    "evidenceFragment": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "surfaceVersion": {
      "type": "string"
    }
  },
  "required": [
    "status",
    "component",
    "diagnostics",
    "repair",
    "variants",
    "surfaceVersion"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢explainChart(component, props)

Return reader grounding: chart description, communicative intent, and navigable data structure.

Input Schema

{
  "type": "object",
  "properties": {
    "component": {
      "type": "string"
    },
    "props": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "component",
    "props"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "const": "grounded"
    },
    "grounding": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "evidenceFragment": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "surfaceVersion": {
      "type": "string"
    }
  },
  "required": [
    "status",
    "grounding",
    "surfaceVersion"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢auditChart(component, props, viewportWidth)

Run design diagnostics plus accessibility and mobile audits, returning prioritized structured findings.

Input Schema

{
  "type": "object",
  "properties": {
    "component": {
      "type": "string"
    },
    "props": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "viewportWidth": {
      "type": "integer",
      "minimum": 240,
      "maximum": 1600
    }
  },
  "required": [
    "component",
    "props"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "passed",
        "findings"
      ]
    },
    "component": {
      "type": "string"
    },
    "evidenceEnvelope": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "evidenceGate": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "surfaceVersion": {
      "type": "string"
    }
  },
  "required": [
    "status",
    "component",
    "surfaceVersion"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢getChartSchema(component)

Return canonical Semiotic prop-schema guidance for code editing and advanced configuration.

Input Schema

{
  "type": "object",
  "properties": {
    "component": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "component-list",
        "component-schema",
        "unknown-component"
      ]
    },
    "component": {
      "type": "string"
    },
    "renderable": {
      "type": "boolean"
    },
    "availableComponents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "renderable": {
            "type": "boolean"
          }
        },
        "required": [
          "name",
          "renderable"
        ],
        "additionalProperties": false
      }
    },
    "schema": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "accessibility": {
      "type": "object",
      "properties": {
        "directProps": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "chartContainer": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "directProps",
        "chartContainer"
      ],
      "additionalProperties": false
    },
    "behaviorContracts": {
      "type": "array",
      "items": {}
    },
    "surfaceVersion": {
      "type": "string"
    }
  },
  "required": [
    "status",
    "surfaceVersion"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded5 tools
verifiedversion not recorded5 tools