# io.github.vlad-public-code/valem: tool descriptions scored

- tools/list taken: 2026-11-02 (UTC)
- From: [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/io.github.vlad-public-code%2Fvalem/versions/latest)
- Connected to: https://valem.run/mcp
- Homepage: https://valem.run/
- Repository: https://github.com/vlad-public-code/org.json-kula.valem
- Scoring rules: v2
- Tools: 35
- Average: 60.4 / 100 (Cloudy)
- Near-identical pairs: 1

This page shows how io.github.vlad-public-code/valem's tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

## Across the server

- Minor: 35 tools. Above 25, models start to tell tools apart less well.

## Tools

- `get_spec`: 39 / 100
  - Major: The description only restates the name (9 words).
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `get_history`: 42 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `valem_card_edit`: 44 / 100
  - Major: Arguments without a description: id, specHash, mutations.
  - Minor: String arguments with no constraint or example: id, specHash.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `valem_recompute`: 44 / 100
  - Major: Arguments without a description: specHash, inputs, spec.
  - Minor: String arguments with no constraint or example: specHash.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `list_models`: 45 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `valem_spec_guide`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `delete_model`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `get_model_info`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `test_spec`: 50 / 100
  - Major: Arguments without a description: spec.id, spec.version, spec.schema, spec.constants, spec.library, spec.library.define, spec.library.description, spec.library.signatures, spec.defaultValues, spec.defaultValues[].path, spec.defaultValues[].expr, spec.defaultValues[].description, spec.derivations, spec.derivations[].path, spec.derivations[].expr, spec.derivations[].evaluation, spec.metaDerivations, spec.metaDerivations[].path, spec.metaDerivations[].property, spec.metaDerivations[].expr, spec.constraints, spec.constraints[].id, spec.constraints[].expr, spec.constraints[].message, spec.constraints[].policy, spec.constraints[].path, spec.effects, spec.effects[].id, spec.effects[].executor, spec.effects[].trigger, spec.effects[].dedupeKey, spec.effects[].statusPath, spec.effects[].emit, spec.effects[].payload, spec.effects[].request, spec.effects[].requests, spec.effects[].prompt, spec.effects[].responseSchema, spec.effects[].at, spec.effects[].afterMs, spec.effects[].response, spec.effects[].policy, spec.tests, spec.tests[].description, spec.tests[].given, spec.tests[].expect, spec.viewDefinition.
  - Minor: String arguments with no constraint or example: spec.id, spec.version, spec.library.define, spec.library.description, spec.defaultValues[].path, spec.defaultValues[].expr, spec.defaultValues[].description, spec.derivations[].path, spec.derivations[].expr, spec.metaDerivations[].path, spec.metaDerivations[].property, spec.metaDerivations[].expr, spec.constraints[].id, spec.constraints[].expr, spec.constraints[].message, spec.constraints[].path, spec.effects[].id, spec.effects[].trigger, spec.effects[].dedupeKey, spec.effects[].statusPath, spec.effects[].emit, spec.effects[].requests, spec.effects[].prompt, spec.effects[].at, spec.effects[].afterMs, spec.tests[].description.
- `get_field`: 52 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `get_audit`: 53 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `dry_run`: 54 / 100
  - Major: Arguments without a description: spec.id, spec.version, spec.schema, spec.constants, spec.library, spec.library.define, spec.library.description, spec.library.signatures, spec.defaultValues, spec.defaultValues[].path, spec.defaultValues[].expr, spec.defaultValues[].description, spec.derivations, spec.derivations[].path, spec.derivations[].expr, spec.derivations[].evaluation, spec.metaDerivations, spec.metaDerivations[].path, spec.metaDerivations[].property, spec.metaDerivations[].expr, spec.constraints, spec.constraints[].id, spec.constraints[].expr, spec.constraints[].message, spec.constraints[].policy, spec.constraints[].path, spec.effects, spec.effects[].id, spec.effects[].executor, spec.effects[].trigger, spec.effects[].dedupeKey, spec.effects[].statusPath, spec.effects[].emit, spec.effects[].payload, spec.effects[].request, spec.effects[].requests, spec.effects[].prompt, spec.effects[].responseSchema, spec.effects[].at, spec.effects[].afterMs, spec.effects[].response, spec.effects[].policy, spec.tests, spec.tests[].description, spec.tests[].given, spec.tests[].expect, spec.viewDefinition.
  - Minor: String arguments with no constraint or example: spec.id, spec.version, spec.library.define, spec.library.description, spec.defaultValues[].path, spec.defaultValues[].expr, spec.defaultValues[].description, spec.derivations[].path, spec.derivations[].expr, spec.metaDerivations[].path, spec.metaDerivations[].property, spec.metaDerivations[].expr, spec.constraints[].id, spec.constraints[].expr, spec.constraints[].message, spec.constraints[].path, spec.effects[].id, spec.effects[].trigger, spec.effects[].dedupeKey, spec.effects[].statusPath, spec.effects[].emit, spec.effects[].requests, spec.effects[].prompt, spec.effects[].at, spec.effects[].afterMs, spec.tests[].description.
- `evolve_spec`: 55 / 100
  - Major: Arguments without a description: evolution.newVersion, evolution.newSchema, evolution.newViewDefinition, evolution.upsertDerivations, evolution.upsertDerivations[].path, evolution.upsertDerivations[].expr, evolution.upsertDerivations[].evaluation, evolution.removeDerivations, evolution.upsertMetaDerivations, evolution.upsertMetaDerivations[].path, evolution.upsertMetaDerivations[].property, evolution.upsertMetaDerivations[].expr, evolution.removeMetaDerivations, evolution.upsertDefaultValues, evolution.upsertDefaultValues[].path, evolution.upsertDefaultValues[].expr, evolution.upsertDefaultValues[].description, evolution.removeDefaultValues, evolution.newConstants, evolution.upsertConstraints, evolution.upsertConstraints[].id, evolution.upsertConstraints[].expr, evolution.upsertConstraints[].message, evolution.upsertConstraints[].policy, evolution.upsertConstraints[].path, evolution.removeConstraints, evolution.upsertEffects, evolution.upsertEffects[].id, evolution.upsertEffects[].executor, evolution.upsertEffects[].trigger, evolution.upsertEffects[].dedupeKey, evolution.upsertEffects[].statusPath, evolution.upsertEffects[].emit, evolution.upsertEffects[].payload, evolution.upsertEffects[].request, evolution.upsertEffects[].requests, evolution.upsertEffects[].prompt, evolution.upsertEffects[].responseSchema, evolution.upsertEffects[].at, evolution.upsertEffects[].afterMs, evolution.upsertEffects[].response, evolution.upsertEffects[].policy, evolution.removeEffects, evolution.backfill, evolution.expectedVersion, evolution.upsertSchemaDefs, evolution.removeSchemaDefs, evolution.upsertSchemaNodes, evolution.upsertSchemaNodes[].path, evolution.upsertSchemaNodes[].schema, evolution.upsertSchemaNodes[].required, evolution.removeSchemaNodes, evolution.newDefaultView, evolution.upsertViews, evolution.removeViews, evolution.upsertComponents, evolution.upsertComponents[].viewId, evolution.upsertComponents[].parentId, evolution.upsertComponents[].beforeId, evolution.upsertComponents[].component, evolution.removeComponents, evolution.removeComponents[].viewId, evolution.removeComponents[].componentId, evolution.upsertConstants, evolution.removeConstants, evolution.newLibrary, evolution.newLibrary.define, evolution.newLibrary.signatures.
  - Minor: String arguments with no constraint or example: id, evolution.newVersion, evolution.upsertDerivations[].path, evolution.upsertDerivations[].expr, evolution.upsertMetaDerivations[].path, evolution.upsertMetaDerivations[].property, evolution.upsertMetaDerivations[].expr, evolution.upsertDefaultValues[].path, evolution.upsertDefaultValues[].expr, evolution.upsertDefaultValues[].description, evolution.upsertConstraints[].id, evolution.upsertConstraints[].expr, evolution.upsertConstraints[].message, evolution.upsertConstraints[].path, evolution.upsertEffects[].id, evolution.upsertEffects[].trigger, evolution.upsertEffects[].dedupeKey, evolution.upsertEffects[].statusPath, evolution.upsertEffects[].emit, evolution.upsertEffects[].requests, evolution.upsertEffects[].prompt, evolution.upsertEffects[].at, evolution.upsertEffects[].afterMs, evolution.expectedVersion, evolution.upsertSchemaNodes[].path, evolution.newDefaultView, evolution.upsertComponents[].viewId, evolution.upsertComponents[].parentId, evolution.upsertComponents[].beforeId, evolution.removeComponents[].viewId, evolution.removeComponents[].componentId, evolution.newLibrary.define.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: The meaning of the boolean argument evolution.upsertSchemaNodes[].required is unclear.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `snapshot`: 55 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `validate_spec`: 56 / 100
  - Major: Arguments without a description: spec.id, spec.version, spec.schema, spec.constants, spec.library, spec.library.define, spec.library.description, spec.library.signatures, spec.defaultValues, spec.defaultValues[].path, spec.defaultValues[].expr, spec.defaultValues[].description, spec.derivations, spec.derivations[].path, spec.derivations[].expr, spec.derivations[].evaluation, spec.metaDerivations, spec.metaDerivations[].path, spec.metaDerivations[].property, spec.metaDerivations[].expr, spec.constraints, spec.constraints[].id, spec.constraints[].expr, spec.constraints[].message, spec.constraints[].policy, spec.constraints[].path, spec.effects, spec.effects[].id, spec.effects[].executor, spec.effects[].trigger, spec.effects[].dedupeKey, spec.effects[].statusPath, spec.effects[].emit, spec.effects[].payload, spec.effects[].request, spec.effects[].requests, spec.effects[].prompt, spec.effects[].responseSchema, spec.effects[].at, spec.effects[].afterMs, spec.effects[].response, spec.effects[].policy, spec.tests, spec.tests[].description, spec.tests[].given, spec.tests[].expect, spec.viewDefinition.
  - Minor: String arguments with no constraint or example: spec.id, spec.version, spec.library.define, spec.library.description, spec.defaultValues[].path, spec.defaultValues[].expr, spec.defaultValues[].description, spec.derivations[].path, spec.derivations[].expr, spec.metaDerivations[].path, spec.metaDerivations[].property, spec.metaDerivations[].expr, spec.constraints[].id, spec.constraints[].expr, spec.constraints[].message, spec.constraints[].path, spec.effects[].id, spec.effects[].trigger, spec.effects[].dedupeKey, spec.effects[].statusPath, spec.effects[].emit, spec.effects[].requests, spec.effects[].prompt, spec.effects[].at, spec.effects[].afterMs, spec.tests[].description.
  - Minor: The description mentions none of its 3 or more arguments.
- `restore`: 60 / 100
  - Minor: String arguments with no constraint or example: id.
  - Minor: Says nothing about what it returns.
- `create_model`: 61 / 100
  - Major: Arguments without a description: spec.id, spec.version, spec.schema, spec.constants, spec.library, spec.library.define, spec.library.description, spec.library.signatures, spec.defaultValues, spec.defaultValues[].path, spec.defaultValues[].expr, spec.defaultValues[].description, spec.derivations, spec.derivations[].path, spec.derivations[].expr, spec.derivations[].evaluation, spec.metaDerivations, spec.metaDerivations[].path, spec.metaDerivations[].property, spec.metaDerivations[].expr, spec.constraints, spec.constraints[].id, spec.constraints[].expr, spec.constraints[].message, spec.constraints[].policy, spec.constraints[].path, spec.effects, spec.effects[].id, spec.effects[].executor, spec.effects[].trigger, spec.effects[].dedupeKey, spec.effects[].statusPath, spec.effects[].emit, spec.effects[].payload, spec.effects[].request, spec.effects[].requests, spec.effects[].prompt, spec.effects[].responseSchema, spec.effects[].at, spec.effects[].afterMs, spec.effects[].response, spec.effects[].policy, spec.tests, spec.tests[].description, spec.tests[].given, spec.tests[].expect, spec.viewDefinition.
  - Minor: String arguments with no constraint or example: spec.id, spec.version, spec.library.define, spec.library.description, spec.defaultValues[].path, spec.defaultValues[].expr, spec.defaultValues[].description, spec.derivations[].path, spec.derivations[].expr, spec.metaDerivations[].path, spec.metaDerivations[].property, spec.metaDerivations[].expr, spec.constraints[].id, spec.constraints[].expr, spec.constraints[].message, spec.constraints[].path, spec.effects[].id, spec.effects[].trigger, spec.effects[].dedupeKey, spec.effects[].statusPath, spec.effects[].emit, spec.effects[].requests, spec.effects[].prompt, spec.effects[].at, spec.effects[].afterMs, spec.tests[].description.
- `get_view`: 62 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `explain`: 65 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `patch_model`: 65 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `show_model`: 65 / 100
  - Minor: String arguments with no constraint or example: id.
  - Minor: Says nothing about what it returns.
- `upload_blob`: 65 / 100
  - Major: Says nothing about when to use it, or when not to.
- `verify_audit`: 65 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `get_state`: 66 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `explain_value`: 67 / 100
- `convert_spreadsheet`: 68 / 100
  - Minor: The description mentions none of its 3 or more arguments.
- `download_blob`: 68 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Required identifiers whose description does not say where the value comes from: blobId. Name the tool or the place that returns it, or models look it up first.
- `get_domain_guidance`: 68 / 100
  - Major: Says nothing about when to use it, or when not to.
- `get_effective_schema`: 71 / 100
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `eval_expression`: 72 / 100
- `get_library`: 75 / 100
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `pair_browser`: 76 / 100
- `render_model`: 77 / 100
- `mutate`: 80 / 100
  - Minor: String arguments with no constraint or example: id.
  - Minor: Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.
- `search_document`: 80 / 100

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

[All scored servers](https://forecall.dev/en/servers)