data Static interface comparison

Pinecone MCP

0.2.1 0.3.0

FAILPending human review

1 new write capability requires explicit review.1 new destructive capability requires 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.

Tools1 → 9
Added8
Removed0
Schema changes0
Input schema changes0
Output schema changes0
Unclassified schema changes0
Description changes1
New write authority1
New destructive authority1
New unknown authority0
AnalysisFAIL

INTERFACE DIFF

What changed, tool by tool

Classification from the recorded findings · definitions from the published snapshots

9 tools with recorded changes

  1. create-index-for-modelAddedAuthorityFAIL

    What changed

    • New tool create-index-for-model, declared with write effect.

    Why it could matter

    • Agents connected to this release can be offered an operation that changes data, which the earlier release did not expose.

    What to verify

    • Review whether this operation should be exposed through your agent’s tool configuration.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.2.1)Current (0.3.0)Change
    (schema root)not presentobject
    • Added
    cloudnot presentstring, default="aws", enum (3)optional
    • Added
    embednot presentobjectrequired
    • Added
    embed › fieldMapnot presentobjectrequired
    • Added
    embed › fieldMap › textnot presentstringrequired
    • Added
    embed › modelnot presentstring, enum (3)required
    • Added
    llm_modelnot presentstringoptional
    • Added
    llm_providernot presentstringoptional
    • Added
    namenot presentstringrequired
    • Added
    regionnot presentstring, default="us-east-1"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
  2. describe-indexAddedAddedINFO

    What changed

    • New read-only tool describe-index.

    Why it could matter

    • The release adds a capability without declared write authority.

    What to verify

    • Decide whether agents should be offered this tool.
    Declared effect
    — → read

    Input schema

    PropertyPrevious (0.2.1)Current (0.3.0)Change
    (schema root)not presentobject
    • Added
    llm_modelnot presentstringoptional
    • Added
    llm_providernot presentstringoptional
    • Added
    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
  3. describe-index-statsAddedAddedINFO

    What changed

    • New read-only tool describe-index-stats.

    Why it could matter

    • The release adds a capability without declared write authority.

    What to verify

    • Decide whether agents should be offered this tool.
    Declared effect
    — → read

    Input schema

    PropertyPrevious (0.2.1)Current (0.3.0)Change
    (schema root)not presentobject
    • Added
    llm_modelnot presentstringoptional
    • Added
    llm_providernot presentstringoptional
    • Added
    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. list-indexesAddedAddedINFO

    What changed

    • New read-only tool list-indexes.

    Why it could matter

    • The release adds a capability without declared write authority.

    What to verify

    • Decide whether agents should be offered this tool.
    Declared effect
    — → read

    Input schema

    PropertyPrevious (0.2.1)Current (0.3.0)Change
    (schema root)not presentobject
    • Added
    llm_modelnot presentstringoptional
    • Added
    llm_providernot presentstringoptional
    • 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
  5. rerank-documentsAddedAddedINFO

    What changed

    • New read-only tool rerank-documents.

    Why it could matter

    • The release adds a capability without declared write authority.

    What to verify

    • Decide whether agents should be offered this tool.
    Declared effect
    — → read

    Input schema

    PropertyPrevious (0.2.1)Current (0.3.0)Change
    (schema root)not presentobject
    • Added
    documentsnot present{}required
    • Added
    llm_modelnot presentstringoptional
    • Added
    llm_providernot presentstringoptional
    • Added
    modelnot presentstring, enum (3)required
    • Added
    optionsnot presentobjectoptional
    • Added
    options › rankFieldsnot presentarrayoptional
    • Added
    options › rankFields › [items]not presentstring
    • Added
    options › topNnot presentnumberrequired
    • Added
    querynot 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. search-docsModifiedFindingDescriptionMetadataINFO

    What changed

    • search-docs: declared effect unknown → read.
    • search-docs: description changed.
    • search-docs: declared metadata changed (title "" → "Search Pinecone Documentation"; declared idempotent: unknown → false).

    Why it could matter

    • See the full evidence for this finding.
    • 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

    • Review the recorded finding in the published comparison.
    • Spot-check that agents still select this tool as intended.
    • Confirm any client logic that relies on these annotations.
    Declared effect
    unknown → read
    Description
    PreviousSearch Pinecone documentation for relevant information
    CurrentSearch the official Pinecone documentation for relevant information. Use this before writing Pinecone code or explaining Pinecone behavior, rather than relying on assumptions.

    Input schema

    Input schema unchanged.

    2 unchanged entries
    • (schema root)
    • query

    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. search-recordsAddedAddedINFO

    What changed

    • New read-only tool search-records.

    Why it could matter

    • The release adds a capability without declared write authority.

    What to verify

    • Decide whether agents should be offered this tool.
    Declared effect
    — → read

    Input schema

    PropertyPrevious (0.2.1)Current (0.3.0)Change
    (schema root)not presentobject
    • Added
    llm_modelnot presentstringoptional
    • Added
    llm_providernot presentstringoptional
    • Added
    namenot presentstringrequired
    • Added
    namespacenot presentstringrequired
    • Added
    querynot presentobjectrequired
    • Added
    query › filternot presentobject, additionalProperties {…}optional
    • Added
    query › inputsnot presentobjectrequired
    • Added
    query › inputs › textnot presentstringrequired
    • Added
    query › topKnot presentnumberrequired
    • Added
    reranknot presentobjectoptional
    • Added
    rerank › modelnot presentstring, enum (3)required
    • Added
    rerank › querynot presentstringoptional
    • Added
    rerank › rankFieldsnot presentarrayrequired
    • Added
    rerank › rankFields › [items]not presentstring
    • Added
    rerank › topNnot presentnumberoptional
    • 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. upsert-recordsAddedAuthorityFAIL

    What changed

    • New tool upsert-records, 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.2.1)Current (0.3.0)Change
    (schema root)not presentobject
    • Added
    llm_modelnot presentstringoptional
    • Added
    llm_providernot presentstringoptional
    • Added
    namenot presentstringrequired
    • Added
    namespacenot presentstringrequired
    • Added
    recordsnot presentarrayrequired
    • Added
    records › [items]not presentobject, additionalProperties {…}, propertyNames {…}
    • 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

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
pinecone/0.2.1~0.3.0The published comparison identifier.
Analyzer
modelara v0.1.8Policy version not recorded.Analyzed Nov 15, 2026, 3:10 AM UTC.
Distribution
npm
Previous release
@pinecone-database/mcp@0.2.11 tools · published by the registry Feb 5, 2026, 10:54 PM UTCArtifact integritysha512-B9RABhw2060nwscEhDSeIrDSA3/Nun7fhdaSYgbzZHsLrbnJSt87Gg/aZPrbDEshiEjkLAWYJI58bpu8ZrtZWg==Interface fingerprintsha256:3bfafcef2b97cbb65f6b38b6a70a284153feae6ce16c5329d5ec617c31285162Exact interface snapshot (JSON)
Current release
@pinecone-database/mcp@0.3.09 tools · published by the registry Aug 7, 2026, 3:38 PM UTCArtifact integritysha512-hC8nc4VgNi6wbXkergDP3q/8zHnhx67HtuL/lNPtvnlfCmIGNTMEYXX6hkWvvqhHliDTwK+Y8PnIHR3IBRkSVw==Interface fingerprintsha256:7db05adbc00fd3a8defeb737029984bf1564018031d3b8585a523c1dc89f8195Exact 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

2 findings
  • create-index-for-modelFAILAdded

    New capability with write effect

    Authority
    —WRITE
  • upsert-recordsFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE

Informational

9 findings
  • search-docsINFOChanged

    Declared effect unknown → read

    Authority
    UNKNOWNREAD
  • cascading-searchINFOAdded

    New read-only capability

    Authority
    —READ
  • describe-indexINFOAdded

    New read-only capability

    Authority
    —READ
  • describe-index-statsINFOAdded

    New read-only capability

    Authority
    —READ
  • list-indexesINFOAdded

    New read-only capability

    Authority
    —READ
  • rerank-documentsINFOAdded

    New read-only capability

    Authority
    —READ
  • search-recordsINFOAdded

    New read-only capability

    Authority
    —READ
  • search-docsINFOChanged

    Description changed

    Authority
    UNKNOWNREAD
  • search-docsINFOChanged

    Metadata changed

    Show details
    • title "" → "Search Pinecone Documentation"
    • declared idempotent: unknown → false
    Authority
    UNKNOWNREAD
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 Pinecone MCP release history