data Static interface comparison
Pinecone MCP
0.2.1 0.3.0
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.
INTERFACE DIFF
What changed, tool by tool
- 8Added tools
- 0Removed tools
- 1Modified tools
- 0Input-schema changes
- 0Output-schema changes
- 2Declared authority changes
9 tools with recorded changes
cascading-searchAddedWhat changed
- New read-only tool cascading-search.
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
Property Previous (0.2.1) Current (0.3.0) Change (schema root)not present object - Added
indexesnot present arrayrequired - Added
indexes › [items]not present object - Added
indexes › [items] › namenot present stringrequired - Added
indexes › [items] › namespacenot present stringrequired - Added
llm_modelnot present stringoptional - Added
llm_providernot present stringoptional - Added
querynot present objectrequired - Added
query › filternot present object, additionalProperties {…}optional - Added
query › inputsnot present objectrequired - Added
query › inputs › textnot present stringrequired - Added
query › topKnot present numberrequired - Added
reranknot present objectrequired - Added
rerank › modelnot present string, enum (3)required - Added
rerank › querynot present stringoptional - Added
rerank › rankFieldsnot present arrayrequired - Added
rerank › rankFields › [items]not present string - Added
rerank › topNnot present numberoptional - Added
No output schema is recorded for this tool in either release.
Link to this toolExact 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.
create-index-for-modelAddedWhat 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
Property Previous (0.2.1) Current (0.3.0) Change (schema root)not present object - Added
cloudnot present string, default="aws", enum (3)optional - Added
embednot present objectrequired - Added
embed › fieldMapnot present objectrequired - Added
embed › fieldMap › textnot present stringrequired - Added
embed › modelnot present string, enum (3)required - Added
llm_modelnot present stringoptional - Added
llm_providernot present stringoptional - Added
namenot present stringrequired - Added
regionnot present string, default="us-east-1"optional - Added
No output schema is recorded for this tool in either release.
Link to this toolExact 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.
describe-indexAddedWhat 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
Property Previous (0.2.1) Current (0.3.0) Change (schema root)not present object - Added
llm_modelnot present stringoptional - Added
llm_providernot present stringoptional - Added
namenot present stringrequired - Added
No output schema is recorded for this tool in either release.
Link to this toolExact 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.
describe-index-statsAddedWhat 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
Property Previous (0.2.1) Current (0.3.0) Change (schema root)not present object - Added
llm_modelnot present stringoptional - Added
llm_providernot present stringoptional - Added
namenot present stringrequired - Added
No output schema is recorded for this tool in either release.
Link to this toolExact 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.
list-indexesAddedWhat 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
Property Previous (0.2.1) Current (0.3.0) Change (schema root)not present object - Added
llm_modelnot present stringoptional - Added
llm_providernot present stringoptional - Added
No output schema is recorded for this tool in either release.
Link to this toolExact 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.
rerank-documentsAddedWhat 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
Property Previous (0.2.1) Current (0.3.0) Change (schema root)not present object - Added
documentsnot present {}required - Added
llm_modelnot present stringoptional - Added
llm_providernot present stringoptional - Added
modelnot present string, enum (3)required - Added
optionsnot present objectoptional - Added
options › rankFieldsnot present arrayoptional - Added
options › rankFields › [items]not present string - Added
options › topNnot present numberrequired - Added
querynot present stringrequired - Added
No output schema is recorded for this tool in either release.
Link to this toolExact 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.
search-docsModifiedWhat 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.
Link to this toolExact 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.
search-recordsAddedWhat 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
Property Previous (0.2.1) Current (0.3.0) Change (schema root)not present object - Added
llm_modelnot present stringoptional - Added
llm_providernot present stringoptional - Added
namenot present stringrequired - Added
namespacenot present stringrequired - Added
querynot present objectrequired - Added
query › filternot present object, additionalProperties {…}optional - Added
query › inputsnot present objectrequired - Added
query › inputs › textnot present stringrequired - Added
query › topKnot present numberrequired - Added
reranknot present objectoptional - Added
rerank › modelnot present string, enum (3)required - Added
rerank › querynot present stringoptional - Added
rerank › rankFieldsnot present arrayrequired - Added
rerank › rankFields › [items]not present string - Added
rerank › topNnot present numberoptional - Added
No output schema is recorded for this tool in either release.
Link to this toolExact 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.
upsert-recordsAddedWhat 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
Property Previous (0.2.1) Current (0.3.0) Change (schema root)not present object - Added
llm_modelnot present stringoptional - Added
llm_providernot present stringoptional - Added
namenot present stringrequired - Added
namespacenot present stringrequired - Added
recordsnot present arrayrequired - Added
records › [items]not present object, additionalProperties {…}, propertyNames {…} - Added
No output schema is recorded for this tool in either release.
Link to this toolExact 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.
No tools match these filters.
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)- Comparison record
- Exact comparison record (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
Policy failures
2 findingscreate-index-for-modelFAILAddedupsert-recordsFAILAdded
Informational
9 findingssearch-docsINFOChangedcascading-searchINFOAddeddescribe-indexINFOAddeddescribe-index-statsINFOAddedlist-indexesINFOAddedrerank-documentsINFOAddedsearch-recordsINFOAddedsearch-docsINFOChangedsearch-docsINFOChangedShow details
title "" → "Search Pinecone Documentation"declared idempotent: unknown → false
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.