data Static interface comparison

Pinecone MCP

0.3.0 0.4.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.

Tools9 → 12
Added3
Removed0
Schema changes0
Input schema changes0
Output schema changes0
Unclassified schema changes0
Description changes3
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

6 tools with recorded changes

  1. create-document-indexAddedAuthorityFAIL

    What changed

    • New tool create-document-index, 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.3.0)Current (0.4.0)Change
    (schema root)not presentobject
    • Added
    cloudnot presentstring, default="aws", enum (3)optional
    • Added
    fieldsnot presentobject, additionalProperties {…}, propertyNames {…}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. create-index-for-modelModifiedDescriptionINFO

    What changed

    • create-index-for-model: description changed.

    Why it could matter

    • Models choose and call tools partly from their descriptions.

    What to verify

    • Spot-check that agents still select this tool as intended.
    Declared effect
    write → write
    Description
    PreviousCreate a Pinecone index with integrated inference, which automatically embeds the text field named in "fieldMap". Supports AWS, GCP, and Azure cloud providers. This call blocks until the index is ready to accept upserts and queries, so no readiness polling is needed afterwards. If an index with the same name already exists, it is returned unchanged instead of erroring.
    CurrentCreate a Pinecone index with integrated inference, which automatically embeds the text field named in "fieldMap". Supports AWS, GCP, and Azure cloud providers. This call blocks until the index is ready to accept upserts and queries, so no readiness polling is needed afterwards. If an index with the same name already exists, it is returned unchanged instead of erroring. For a new index, prefer create-document-index, which supports full-text search and integrated embedding on the same field.

    Input schema

    Input schema unchanged.

    10 unchanged entries
    • (schema root)
    • cloud
    • embed
    • embed › fieldMap
    • embed › fieldMap › text
    • embed › model
    • llm_model
    • llm_provider
    • name
    • region

    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. search-document-indexAddedAddedINFO

    What changed

    • New read-only tool search-document-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.3.0)Current (0.4.0)Change
    (schema root)not presentobject
    • Added
    filternot presentobject, additionalProperties {…}, propertyNames {…}optional
    • Added
    includeFieldsnot presentarray, default (1)optional
    • Added
    includeFields › [items]not presentstring
    • Added
    llm_modelnot presentstringoptional
    • Added
    llm_providernot presentstringoptional
    • Added
    namenot presentstringrequired
    • Added
    namespacenot presentstring, default="__default__"optional
    • Added
    scoreBynot presentarray, minItems=1required
    • Added
    scoreBy › [items]not presentobject
    • Added
    scoreBy › [items] › fieldsnot presentarrayoptional
    • Added
    scoreBy › [items] › fields › [items]not presentstring
    • Added
    scoreBy › [items] › querynot presentstringrequired
    • Added
    scoreBy › [items] › typenot presentstring, enum (4)required
    • Added
    topKnot presentinteger, default=10, maximum=9007199254740991, minimum=1optional
    • 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. search-recordsModifiedDescriptionINFO

    What changed

    • search-records: description changed.

    Why it could matter

    • Models choose and call tools partly from their descriptions.

    What to verify

    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → read
    Description
    PreviousSearch an index for records that are semantically similar to the query text. Only works with integrated-inference indexes (e.g. created with create-index-for-model), which embed the query automatically; it fails on standard indexes — use describe-index to check the index type. Returns hits with "_id", "_score", and the record's stored "fields". Newly upserted records can take a few seconds to be indexed and become visible to search results and index stats; if recent data is missing, wait briefly and retry.
    CurrentSearch an index for records that are semantically similar to the query text. Only works with integrated-inference indexes (e.g. created with create-index-for-model), which embed the query automatically; it fails on standard indexes and document indexes (use search-document-index for those) — use describe-index to check the index type. Returns hits with "_id", "_score", and the record's stored "fields". Newly upserted records can take a few seconds to be indexed and become visible to search results and index stats; if recent data is missing, wait briefly and retry.

    Input schema

    Input schema unchanged.

    16 unchanged entries
    • (schema root)
    • llm_model
    • llm_provider
    • name
    • namespace
    • query
    • query › filter
    • query › inputs
    • query › inputs › text
    • query › topK
    • rerank
    • rerank › model
    • rerank › query
    • rerank › rankFields
    • rerank › rankFields › [items]
    • rerank › topN

    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. upsert-documentsAddedAuthorityFAIL

    What changed

    • New tool upsert-documents, 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.3.0)Current (0.4.0)Change
    (schema root)not presentobject
    • Added
    documentsnot presentarray, minItems=1required
    • Added
    documents › [items]not presentobject, additionalProperties {…}, propertyNames {…}
    • Added
    llm_modelnot presentstringoptional
    • Added
    llm_providernot presentstringoptional
    • Added
    namenot presentstringrequired
    • Added
    namespacenot presentstring, default="__default__"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
  6. upsert-recordsModifiedDescriptionINFO

    What changed

    • upsert-records: description changed.

    Why it could matter

    • Models choose and call tools partly from their descriptions.

    What to verify

    • Spot-check that agents still select this tool as intended.
    Declared effect
    write → write
    Description
    PreviousInsert or update records in an integrated Pinecone index. Text in the field named by the index's "fieldMap" is embedded automatically — call describe-index first to confirm that field name. Records with an existing "id" are overwritten. Newly upserted records can take a few seconds to be indexed and become visible to search results and index stats; if recent data is missing, wait briefly and retry.
    CurrentInsert or update records in an integrated Pinecone index. For a document index, use upsert-documents instead. Text in the field named by the index's "fieldMap" is embedded automatically — call describe-index first to confirm that field name. Records with an existing "id" are overwritten. Newly upserted records can take a few seconds to be indexed and become visible to search results and index stats; if recent data is missing, wait briefly and retry.

    Input schema

    Input schema unchanged.

    7 unchanged entries
    • (schema root)
    • llm_model
    • llm_provider
    • name
    • namespace
    • records
    • records › [items]

    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 tools with no recorded change
  • cascading-search
  • describe-index
  • describe-index-stats
  • list-indexes
  • rerank-documents
  • search-docs

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.3.0~0.4.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.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)
Current release
@pinecone-database/mcp@0.4.012 tools · published by the registry Oct 29, 2026, 5:28 PM UTCArtifact integritysha512-JewEAQw+C3vys9hWT4vMePzeP5AA8QZeHMmS4JPtYIuHZtdQRmx0o4DZZCcdXluT8dNEXM3oh1tB473vJgUA8A==Interface fingerprintsha256:a38bfd1ec11bab5f5320081e92a67819117d9c40532a380e332575e6f9120910Exact 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-document-indexFAILAdded

    New capability with write effect

    Authority
    —WRITE
  • upsert-documentsFAILAdded

    New capability with destructive effect

    Authority
    —DESTRUCTIVE

Informational

4 findings
  • search-document-indexINFOAdded

    New read-only capability

    Authority
    —READ
  • create-index-for-modelINFOChanged

    Description changed

    Authority
    WRITEWRITE
    Authority unchanged
  • search-recordsINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
  • upsert-recordsINFOChanged

    Description changed

    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 Pinecone MCP release history