infrastructure Static interface comparison

HashiCorp Vault MCP

0.1.0 0.2.0

FAILPending human review

9 new destructive capabilities require explicit review.

View the upgrade review as Markdown

A shareable summary of this comparison for an issue, pull request or ticket. Select the text and copy it.

Tools7 → 16
Added9
Removed0
Schema changes4
Input schema changes4
Output schema changes0
Unclassified schema changes0
Description changes3
New write authority0
New destructive authority9
New unknown authority0
AnalysisFAIL

INTERFACE DIFF

What changed, tool by tool

Classification from the recorded findings · definitions from the published snapshots

16 tools with recorded changes

  1. create_mountModifiedDescriptionMetadataINFO

    What changed

    • create_mount: description changed.
    • create_mount: declared metadata changed (declared open_world: true → unknown).

    Why it could matter

    • Models choose and call tools partly from their descriptions.
    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Spot-check that agents still select this tool as intended.
    • Confirm any client logic that relies on these annotations.
    Declared effect
    write → write
    Description
    PreviousCreate a new mount in Vault
    CurrentMount a new secrets engine on a specific path in Vault.

    Input schema

    Input schema unchanged.

    5 unchanged entries
    • (schema root)
    • description
    • options
    • path
    • type

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  2. create_pki_issuerAddedAuthorityFAIL

    What changed

    • New tool create_pki_issuer, declared with destructive effect.

    Why it could matter

    • Agents connected to this release can be offered an operation declared as able to delete or irreversibly change data.

    What to verify

    • Review whether this operation should be exposed to agents, and whether it should require explicit approval.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    (schema root)not presentobject
    • Added
    common_namenot presentstringrequired
    • Added
    issuer_namenot presentstringrequired
    • Added
    mountnot presentstring, default="pki"optional
    • Added
    root_issuernot presentstring, default=""optional
    • Added
    root_mountnot presentstring, default=""optional
    • Added
    ttlnot presentstring, default="30d"optional
    • Added
    typenot presentstring, enum (1)required
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  3. create_pki_roleAddedAuthorityFAIL

    What changed

    • New tool create_pki_role, declared with destructive effect.

    Why it could matter

    • Agents connected to this release can be offered an operation declared as able to delete or irreversibly change data.

    What to verify

    • Review whether this operation should be exposed to agents, and whether it should require explicit approval.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    (schema root)not presentobject
    • Added
    allow_any_namenot presentboolean, default=trueoptional
    • Added
    allow_glob_domainsnot presentboolean, default=falseoptional
    • Added
    allow_ip_sansnot presentboolean, default=falseoptional
    • Added
    allowed_domainsnot presentstring, default=""optional
    • Added
    issuer_namenot presentstring, default="default"optional
    • Added
    max_ttlnot presentstring, default="30d"optional
    • Added
    mountnot presentstring, default="pki"optional
    • Added
    role_namenot presentstringrequired
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  4. delete_mountModifiedMetadataINFO

    What changed

    • delete_mount: declared metadata changed (declared idempotent: false → true; declared open_world: true → unknown).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    write → write

    Input schema

    Input schema unchanged.

    2 unchanged entries
    • (schema root)
    • path

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  5. delete_pki_roleAddedAuthorityFAIL

    What changed

    • New tool delete_pki_role, declared with destructive effect.

    Why it could matter

    • Agents connected to this release can be offered an operation declared as able to delete or irreversibly change data.

    What to verify

    • Review whether this operation should be exposed to agents, and whether it should require explicit approval.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    (schema root)not presentobject
    • Added
    mountnot presentstring, default="pki"optional
    • Added
    role_namenot presentstringrequired
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  6. delete_secretModifiedSchemaDescriptionMetadataREVIEWINFO

    What changed

    • delete_secret — Schema change: input property mount changed: description "The mount path of … → "The mount path of ….
    • delete_secret: description changed.
    • delete_secret: declared metadata changed (declared open_world: true → unknown).

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.
    • Models choose and call tools partly from their descriptions.
    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    • Spot-check that agents still select this tool as intended.
    • Confirm any client logic that relies on these annotations.
    Declared effect
    write → write
    Description
    PreviousDelete a secret from a KV mount in Vault using the specified path and mount.
    CurrentDelete a secret from a KV mount in Vault using the specified path and mount. If you specify a key, only that key will be deleted. If no key is specified or you delete the last key, the entire secret will be deleted.

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    mountstringrequiredstringrequired
    • Description changed
    3 unchanged entries
    • (schema root)
    • key
    • path

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  7. enable_pkiAddedAuthorityFAIL

    What changed

    • New tool enable_pki, declared with destructive effect.

    Why it could matter

    • Agents connected to this release can be offered an operation declared as able to delete or irreversibly change data.

    What to verify

    • Review whether this operation should be exposed to agents, and whether it should require explicit approval.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    (schema root)not presentobject
    • Added
    descriptionnot presentstring, default=""optional
    • Added
    max_ttlnot presentstring, default="87600h"optional
    • Added
    pathnot presentstring, default="pki"optional
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  8. issue_pki_certificateAddedAuthorityFAIL

    What changed

    • New tool issue_pki_certificate, declared with destructive effect.

    Why it could matter

    • Agents connected to this release can be offered an operation declared as able to delete or irreversibly change data.

    What to verify

    • Review whether this operation should be exposed to agents, and whether it should require explicit approval.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    (schema root)not presentobject
    • Added
    common_namenot presentstringrequired
    • Added
    mountnot presentstring, default="pki"optional
    • Added
    role_namenot presentstringrequired
    • Added
    ttlnot presentstring, default="30d"optional
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  9. list_mountsModifiedMetadataINFO

    What changed

    • list_mounts: declared metadata changed (declared idempotent: false → true; declared open_world: true → unknown).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    write → write

    Input schema

    Input schema unchanged.

    1 unchanged entry
    • (schema root)

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  10. list_pki_issuersAddedAuthorityFAIL

    What changed

    • New tool list_pki_issuers, declared with destructive effect.

    Why it could matter

    • Agents connected to this release can be offered an operation declared as able to delete or irreversibly change data.

    What to verify

    • Review whether this operation should be exposed to agents, and whether it should require explicit approval.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    (schema root)not presentobject
    • Added
    mountnot presentstring, default="pki"optional
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  11. list_pki_rolesAddedAuthorityFAIL

    What changed

    • New tool list_pki_roles, declared with destructive effect.

    Why it could matter

    • Agents connected to this release can be offered an operation declared as able to delete or irreversibly change data.

    What to verify

    • Review whether this operation should be exposed to agents, and whether it should require explicit approval.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    (schema root)not presentobject
    • Added
    mountnot presentstring, default="pki"optional
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  12. list_secretsModifiedSchemaFindingMetadataREVIEWINFO

    What changed

    • list_secrets — Schema change: input property mount changed: description "The mount path of … → "The mount path of ….
    • list_secrets: declared effect destructive → read.
    • list_secrets: declared metadata changed (declared open_world: true → unknown).

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.
    • See the full evidence for this finding.
    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    • Review the recorded finding in the published comparison.
    • Confirm any client logic that relies on these annotations.
    Declared effect
    write → read

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    mountstringrequiredstringrequired
    • Description changed
    2 unchanged entries
    • (schema root)
    • path

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  13. read_pki_issuerAddedAuthorityFAIL

    What changed

    • New tool read_pki_issuer, declared with destructive effect.

    Why it could matter

    • Agents connected to this release can be offered an operation declared as able to delete or irreversibly change data.

    What to verify

    • Review whether this operation should be exposed to agents, and whether it should require explicit approval.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    (schema root)not presentobject
    • Added
    issuer_namenot presentstringrequired
    • Added
    mountnot presentstring, default="pki"optional
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  14. read_pki_roleAddedAuthorityFAIL

    What changed

    • New tool read_pki_role, declared with destructive effect.

    Why it could matter

    • Agents connected to this release can be offered an operation declared as able to delete or irreversibly change data.

    What to verify

    • Review whether this operation should be exposed to agents, and whether it should require explicit approval.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    (schema root)not presentobject
    • Added
    mountnot presentstring, default="pki"optional
    • Added
    role_namenot presentstringrequired
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  15. read_secretModifiedSchemaDescriptionREVIEWINFO

    What changed

    • read_secret — Schema change: input property mount changed: description "The mount path of … → "The mount path of ….
    • read_secret: description changed.

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.
    • Models choose and call tools partly from their descriptions.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    • Spot-check that agents still select this tool as intended.
    Declared effect
    write → write
    Description
    PreviousRead a secret from a KV mount in Vault
    CurrentRead a secret from a KV mount in at a specific path in Vault.

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    mountstringrequiredstringrequired
    • Description changed
    2 unchanged entries
    • (schema root)
    • path

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  16. write_secretModifiedSchemaMetadataREVIEWINFO

    What changed

    • write_secret — Schema change: input property mount changed: description "The mount path of … → "The mount path of ….
    • write_secret: declared metadata changed (declared open_world: true → unknown).

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.
    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    • Confirm any client logic that relies on these annotations.
    Declared effect
    write → write

    Input schema

    PropertyPrevious (0.1.0)Current (0.2.0)Change
    mountstringrequiredstringrequired
    • Description changed
    4 unchanged entries
    • (schema root)
    • key
    • path
    • value

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool

Evidence and provenance

Static findings
FAIL from Modelara’s automated analysis of the two declared interfaces. A policy outcome, not a security rating or a runtime test.
Human review
Pending human review. No reviewer decision is recorded for this comparison.
Published evidence
Part of Valyd’s published data generation listed in valyd-data-source.json. Published records are not rewritten.
Show provenance and exact files
Comparison
hashicorp-vault/0.1.0~0.2.0The published comparison identifier.
Analyzer
modelara v0.1.8Policy version not recorded.Analyzed Nov 15, 2026, 3:02 AM UTC.
Distribution
oci
Previous release
docker.io/hashicorp/vault-mcp-server@0.1.07 tools · published by the registry Sep 24, 2025, 10:12 PM UTC · upstream 0.1.0Artifact integritysha256-N1PRU5i2jQOH2oSWgdTzQqPLbQfGp2w8tGPiJZPn/Y0=Artifactdocker.io/hashicorp/vault-mcp-server@sha256:3753d15398b68d0387da849681d4f342a3cb6d07c6a76c3cb463e22593e7fd8dInterface fingerprintsha256:81aa23de5265f11277199b6b979862638a611bb3a0826aef99f9f1ecbddb940dExact interface snapshot (JSON)
Current release
docker.io/hashicorp/vault-mcp-server@0.2.016 tools · published by the registry Sep 24, 2025, 10:52 PM UTC · upstream 0.2.0Artifact integritysha256-5OjfL7fSfxLFy40cWzdmOpVprVzgBH+gKBxWoXaSIqo=Artifactdocker.io/hashicorp/vault-mcp-server@sha256:e4e8df2fb7d27f12c5cb8d1c5b37663a9569ad5ce0047fa0281c56a1769222aaInterface fingerprintsha256:e7b262c369a94e58341d5f5c4b2c02735a75f5345829980ae422247b69a56b63Exact interface snapshot (JSON)

The integrity value or digest identifies the exact artifact that was inspected; it does not show that the package is safe. The interface fingerprint identifies the declared tools and schemas Modelara recorded for that release.

MODELARA ANALYSIS OUTPUT

Interface findings

Analyzed with Modelara v0.1.8 · Nov 15, 2026

Policy failures

9 findings
  • create_pki_issuerFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE
  • create_pki_roleFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE
  • delete_pki_roleFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE
  • enable_pkiFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE
  • issue_pki_certificateFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE
  • list_pki_issuersFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE
  • list_pki_rolesFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE
  • read_pki_issuerFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE
  • read_pki_roleFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE

Requires review

4 findings
  • delete_secretREVIEWChanged

    Input schema changed

    Show details
    • input property mount changed: description "The mount path of … → "The mount path of …
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • list_secretsREVIEWChanged

    Input schema changed

    Show details
    • input property mount changed: description "The mount path of … → "The mount path of …
    Authority
    DESTRUCTIVEREAD
  • read_secretREVIEWChanged

    Input schema changed

    Show details
    • input property mount changed: description "The mount path of … → "The mount path of …
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • write_secretREVIEWChanged

    Input schema changed

    Show details
    • input property mount changed: description "The mount path of … → "The mount path of …
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged

Informational

10 findings
  • list_secretsINFOChanged

    Declared effect destructive → read

    Authority
    DESTRUCTIVEREAD
  • create_mountINFOChanged

    Description changed

    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • delete_secretINFOChanged

    Description changed

    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • read_secretINFOChanged

    Description changed

    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • create_mountINFOChanged

    Metadata changed

    Show details
    • declared open_world: true → unknown
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • delete_mountINFOChanged

    Metadata changed

    Show details
    • declared idempotent: false → true
    • declared open_world: true → unknown
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • delete_secretINFOChanged

    Metadata changed

    Show details
    • declared open_world: true → unknown
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • list_mountsINFOChanged

    Metadata changed

    Show details
    • declared idempotent: false → true
    • declared open_world: true → unknown
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • list_secretsINFOChanged

    Metadata changed

    Show details
    • declared open_world: true → unknown
    Authority
    DESTRUCTIVEREAD
  • write_secretINFOChanged

    Metadata changed

    Show details
    • declared open_world: true → unknown
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
What do these results mean?
PASS
No policy-significant interface change detected.
REVIEW
Interface changes require inspection.
FAIL
A policy-significant change was detected.
INVALID
The comparison could not be evaluated reliably.
← Back to HashiCorp Vault MCP release history