{
  "schema_version": 1,
  "server_id": "pinecone",
  "package": "@pinecone-database/mcp",
  "version": "0.3.0",
  "collected_at": "2026-11-15T03:10:12.243Z",
  "analyzed_at": "2026-11-15T03:10:12.243Z",
  "modelara_version": "v0.1.8",
  "fingerprint": "sha256:7db05adbc00fd3a8defeb737029984bf1564018031d3b8585a523c1dc89f8195",
  "tool_count": 9,
  "interface": {
    "format": "modelara.inspect/v0",
    "capability_set": {
      "source": {
        "type": "mcp",
        "name": "pinecone-mcp",
        "version": "0.3.0",
        "protocol_version": "2025-11-25"
      },
      "discovered_at": "2026-11-15T03:10:11.875840133Z",
      "capabilities": [
        {
          "id": "mcp:pinecone-mcp/cascading-search",
          "name": "cascading-search",
          "title": "Cascading Search",
          "description": "Search across multiple indexes for records that are\nsimilar to the query text, then deduplicate and rerank the combined results.\nReranking is required for this tool. Only works with integrated-inference\nindexes. To search a single index, use search-records instead.",
          "source": {
            "type": "mcp",
            "server": "pinecone-mcp",
            "operation": "cascading-search"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "indexes": {
                "description": "The indexes to search across. Records in each index should share a common schema.",
                "items": {
                  "properties": {
                    "name": {
                      "description": "An index to search.",
                      "type": "string"
                    },
                    "namespace": {
                      "description": "A namespace to search.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "name",
                    "namespace"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "llm_model": {
                "description": "Optional. If you are an AI model, use this field to specify your name (e.g., \"gpt-4o\", \"Composer\", \"Claude Sonnet 4\", \"Claude Opus\", \"Gemini 2.5\", \"Cascade\", \"Grok 4.1\", \"Copilot\", \"Devin\", and many others). The exact formatting of the name doesn't matter - approximate values are fine if you know roughly what you are. Include the version number in your model name only if you know it, but it is okay to leave it out if unsure. If you don't know your model name, omit this field entirely.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "llm_provider": {
                "description": "Optional. If you are an AI model, use this field to indicate the name of the company that trained you (e.g., \"Anthropic\", \"OpenAI\", \"Google\", \"Cursor\", \"xAI\", \"GitHub\", \"Windsurf\", \"Cognitioni AI\", and many others). The exact formatting doesn't matter - approximate values are fine. If you don't know your provider, avoid guessing and omit this field.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "query": {
                "description": "A query to search for records.",
                "properties": {
                  "filter": {
                    "additionalProperties": {},
                    "description": "A filter can be used to narrow down results. Use the syntax of\n        MongoDB's query and projection operators: $eq, $ne, $gt, $gte, $lt,\n        $lte, $in, $nin, $exists, $and, $or. Make sure the records in the index\n        contain the fields that you are filtering on. To discover which fields\n        exist, run a search without a filter and inspect the \"fields\" of the\n        returned hits. Filtering on a field that records do not contain\n        returns no results.",
                    "properties": {},
                    "type": "object"
                  },
                  "inputs": {
                    "properties": {
                      "text": {
                        "description": "The text to search for.",
                        "type": "string"
                      }
                    },
                    "required": [
                      "text"
                    ],
                    "type": "object"
                  },
                  "topK": {
                    "description": "The number of results to return. 10 is a reasonable default; use a\n      larger value (e.g. 50) when reranking, so the reranker has more\n      candidates to choose from. Very large values increase latency and\n      response size.",
                    "type": "number"
                  }
                },
                "required": [
                  "topK",
                  "inputs"
                ],
                "type": "object"
              },
              "rerank": {
                "description": "Specifies how the results should be reranked. Use a \"query\" with a \"topK\"\n  that returns more results than you need; then use \"rerank\" to select the\n  most relevant \"topN\" results.",
                "properties": {
                  "model": {
                    "description": "Choose a reranking model:\n- \"cohere-rerank-3.5\" is Cohere's leading reranking model, balancing performance\nand latency for a wide range of enterprise search applications.\n- \"bge-reranker-v2-m3\" is a high-performance, multilingual reranking model that\nworks well on messy data and short queries expected to return medium-length\npassages of text (1-2 paragraphs).\n- \"pinecone-rerank-v0\" is a state of the art reranking model that out-performs\ncompetitors on widely accepted benchmarks. It can handle chunks up to 512 tokens\n(1-2 paragraphs).",
                    "enum": [
                      "cohere-rerank-3.5",
                      "bge-reranker-v2-m3",
                      "pinecone-rerank-v0"
                    ],
                    "type": "string"
                  },
                  "query": {
                    "description": "An optional query to rerank documents against. If not specified, the\n      same query will be used for both the initial search and the reranking.",
                    "type": "string"
                  },
                  "rankFields": {
                    "description": "The fields to rerank on. This should include the field name specified\n    in the index's \"fieldMap\". The \"bge-reranker-v2-m3\" and\n    \"pinecone-rerank-v0\" models support only a single rerank field.\n    \"cohere-rerank-3.5\" supports multiple rerank fields.",
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "topN": {
                    "description": "The number of results to return after reranking. Must be less than or\n      equal to the value of \"query.topK\".",
                    "type": "number"
                  }
                },
                "required": [
                  "model",
                  "rankFields"
                ],
                "type": "object"
              }
            },
            "required": [
              "indexes",
              "query",
              "rerank"
            ],
            "type": "object"
          },
          "declared": {
            "read_only": "true",
            "destructive": "unknown",
            "idempotent": "false",
            "open_world": "unknown"
          },
          "effects": {
            "kind": "read",
            "destructive": "false",
            "external": "unknown"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "read",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:33f16b0638250f51ce5983b2965369aaab803bbaf5771097baf45550a307bf5c"
        },
        {
          "id": "mcp:pinecone-mcp/create-index-for-model",
          "name": "create-index-for-model",
          "title": "Create Index",
          "description": "Create a Pinecone index with integrated inference, which\nautomatically embeds the text field named in \"fieldMap\". Supports AWS, GCP, and\nAzure cloud providers. This call blocks until the index is ready to accept\nupserts and queries, so no readiness polling is needed afterwards. If an index\nwith the same name already exists, it is returned unchanged instead of\nerroring.",
          "source": {
            "type": "mcp",
            "server": "pinecone-mcp",
            "operation": "create-index-for-model"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "cloud": {
                "default": "aws",
                "description": "The cloud provider for the index. Defaults to aws.",
                "enum": [
                  "aws",
                  "gcp",
                  "azure"
                ],
                "type": "string"
              },
              "embed": {
                "description": "Configure an embedding model that converts text into a vector.",
                "properties": {
                  "fieldMap": {
                    "description": "Identify which field from your data records will be embedded.",
                    "properties": {
                      "text": {
                        "description": "The name of the field in the data records that contains the text\n            content to embed. Records in the index must contain this field.",
                        "type": "string"
                      }
                    },
                    "required": [
                      "text"
                    ],
                    "type": "object"
                  },
                  "model": {
                    "description": "Choose an embedding model:\n          - \"multilingual-e5-large\" is an efficient dense embedding model\n          trained on a mixture of multilingual datasets. It works well on messy\n          data and short queries expected to return medium-length passages of\n          text (1-2 paragraphs).\n          - \"llama-text-embed-v2\" is a high-performance dense embedding model\n          optimized for text retrieval and ranking tasks. It is trained on a\n          diverse range of text corpora and provides strong performance on\n          longer passages and structured documents.\n          - \"pinecone-sparse-english-v0\" is a sparse embedding model for\n          converting text to sparse vectors for keyword or hybrid search. The\n          model directly estimates the lexical importance of tokens by\n          leveraging their context.",
                    "enum": [
                      "multilingual-e5-large",
                      "llama-text-embed-v2",
                      "pinecone-sparse-english-v0"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "model",
                  "fieldMap"
                ],
                "type": "object"
              },
              "llm_model": {
                "description": "Optional. If you are an AI model, use this field to specify your name (e.g., \"gpt-4o\", \"Composer\", \"Claude Sonnet 4\", \"Claude Opus\", \"Gemini 2.5\", \"Cascade\", \"Grok 4.1\", \"Copilot\", \"Devin\", and many others). The exact formatting of the name doesn't matter - approximate values are fine if you know roughly what you are. Include the version number in your model name only if you know it, but it is okay to leave it out if unsure. If you don't know your model name, omit this field entirely.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "llm_provider": {
                "description": "Optional. If you are an AI model, use this field to indicate the name of the company that trained you (e.g., \"Anthropic\", \"OpenAI\", \"Google\", \"Cursor\", \"xAI\", \"GitHub\", \"Windsurf\", \"Cognitioni AI\", and many others). The exact formatting doesn't matter - approximate values are fine. If you don't know your provider, avoid guessing and omit this field.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "name": {
                "description": "A unique name to identify the new index.",
                "type": "string"
              },
              "region": {
                "default": "us-east-1",
                "description": "The region for the index. Common regions: aws (us-east-1, us-west-2, eu-west-1), gcp (us-central1, europe-west1), azure (eastus, westeurope). Defaults to us-east-1.",
                "type": "string"
              }
            },
            "required": [
              "name",
              "embed"
            ],
            "type": "object"
          },
          "declared": {
            "read_only": "false",
            "destructive": "false",
            "idempotent": "true",
            "open_world": "unknown"
          },
          "effects": {
            "kind": "write",
            "destructive": "false",
            "external": "unknown"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "write",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:276402c4a6a7e5fcf2cc4f51bd817c19cda721a6567f85d31db63b3c64df7485"
        },
        {
          "id": "mcp:pinecone-mcp/describe-index",
          "name": "describe-index",
          "title": "Describe Index",
          "description": "Describe the configuration of a Pinecone index, including\nits embedding model and the \"fieldMap\" that names the record field holding the\ntext to embed. Call this before upsert-records to learn the required field\nname. Check \"status.ready\" in the response to confirm the index can accept\nupserts and queries.",
          "source": {
            "type": "mcp",
            "server": "pinecone-mcp",
            "operation": "describe-index"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "llm_model": {
                "description": "Optional. If you are an AI model, use this field to specify your name (e.g., \"gpt-4o\", \"Composer\", \"Claude Sonnet 4\", \"Claude Opus\", \"Gemini 2.5\", \"Cascade\", \"Grok 4.1\", \"Copilot\", \"Devin\", and many others). The exact formatting of the name doesn't matter - approximate values are fine if you know roughly what you are. Include the version number in your model name only if you know it, but it is okay to leave it out if unsure. If you don't know your model name, omit this field entirely.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "llm_provider": {
                "description": "Optional. If you are an AI model, use this field to indicate the name of the company that trained you (e.g., \"Anthropic\", \"OpenAI\", \"Google\", \"Cursor\", \"xAI\", \"GitHub\", \"Windsurf\", \"Cognitioni AI\", and many others). The exact formatting doesn't matter - approximate values are fine. If you don't know your provider, avoid guessing and omit this field.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "name": {
                "description": "The index to describe.",
                "type": "string"
              }
            },
            "required": [
              "name"
            ],
            "type": "object"
          },
          "declared": {
            "read_only": "true",
            "destructive": "unknown",
            "idempotent": "false",
            "open_world": "unknown"
          },
          "effects": {
            "kind": "read",
            "destructive": "false",
            "external": "unknown"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "read",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:0d8a57a4a82ecc68c7613db771f02d42a79ab8b9fa3def80f48ec0b966f52fdd"
        },
        {
          "id": "mcp:pinecone-mcp/describe-index-stats",
          "name": "describe-index-stats",
          "title": "Describe Index Stats",
          "description": "Describe the statistics of a Pinecone index, including\nrecord counts per namespace. Use this to discover which namespaces exist in an\nindex. Newly upserted records can take a few seconds\nto be indexed and become visible to search results and index stats; if recent\ndata is missing, wait briefly and retry.",
          "source": {
            "type": "mcp",
            "server": "pinecone-mcp",
            "operation": "describe-index-stats"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "llm_model": {
                "description": "Optional. If you are an AI model, use this field to specify your name (e.g., \"gpt-4o\", \"Composer\", \"Claude Sonnet 4\", \"Claude Opus\", \"Gemini 2.5\", \"Cascade\", \"Grok 4.1\", \"Copilot\", \"Devin\", and many others). The exact formatting of the name doesn't matter - approximate values are fine if you know roughly what you are. Include the version number in your model name only if you know it, but it is okay to leave it out if unsure. If you don't know your model name, omit this field entirely.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "llm_provider": {
                "description": "Optional. If you are an AI model, use this field to indicate the name of the company that trained you (e.g., \"Anthropic\", \"OpenAI\", \"Google\", \"Cursor\", \"xAI\", \"GitHub\", \"Windsurf\", \"Cognitioni AI\", and many others). The exact formatting doesn't matter - approximate values are fine. If you don't know your provider, avoid guessing and omit this field.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "name": {
                "description": "The index to describe.",
                "type": "string"
              }
            },
            "required": [
              "name"
            ],
            "type": "object"
          },
          "declared": {
            "read_only": "true",
            "destructive": "unknown",
            "idempotent": "false",
            "open_world": "unknown"
          },
          "effects": {
            "kind": "read",
            "destructive": "false",
            "external": "unknown"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "read",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:d23433b588fecf7c3731003383809a6435fec8954ed23171b552bbfd2c65aa9f"
        },
        {
          "id": "mcp:pinecone-mcp/list-indexes",
          "name": "list-indexes",
          "title": "List Indexes",
          "description": "List all Pinecone indexes in the project, including each\nindex's configuration and readiness status. Use this to discover valid index\nnames before calling other tools.",
          "source": {
            "type": "mcp",
            "server": "pinecone-mcp",
            "operation": "list-indexes"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "llm_model": {
                "description": "Optional. If you are an AI model, use this field to specify your name (e.g., \"gpt-4o\", \"Composer\", \"Claude Sonnet 4\", \"Claude Opus\", \"Gemini 2.5\", \"Cascade\", \"Grok 4.1\", \"Copilot\", \"Devin\", and many others). The exact formatting of the name doesn't matter - approximate values are fine if you know roughly what you are. Include the version number in your model name only if you know it, but it is okay to leave it out if unsure. If you don't know your model name, omit this field entirely.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "llm_provider": {
                "description": "Optional. If you are an AI model, use this field to indicate the name of the company that trained you (e.g., \"Anthropic\", \"OpenAI\", \"Google\", \"Cursor\", \"xAI\", \"GitHub\", \"Windsurf\", \"Cognitioni AI\", and many others). The exact formatting doesn't matter - approximate values are fine. If you don't know your provider, avoid guessing and omit this field.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              }
            },
            "type": "object"
          },
          "declared": {
            "read_only": "true",
            "destructive": "unknown",
            "idempotent": "false",
            "open_world": "unknown"
          },
          "effects": {
            "kind": "read",
            "destructive": "false",
            "external": "unknown"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "read",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:10a1018203c60eccad99b38c75204845ebf5a4aff934e209ea6df046690d4bb6"
        },
        {
          "id": "mcp:pinecone-mcp/rerank-documents",
          "name": "rerank-documents",
          "title": "Rerank Documents",
          "description": "Rerank a set of provided documents by relevance to a\nquery. Use this for documents that did not come from a Pinecone search (e.g.\nexternally sourced text). To rerank the results of a single-index search,\nprefer the \"rerank\" parameter of search-records instead of calling this tool\nseparately.",
          "source": {
            "type": "mcp",
            "server": "pinecone-mcp",
            "operation": "rerank-documents"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "documents": {
                "description": "A set of documents to rerank. Can either be an array of text documents\n    (strings) or an array of records. Record field values must be strings;\n    records with number, boolean, or array fields are not accepted."
              },
              "llm_model": {
                "description": "Optional. If you are an AI model, use this field to specify your name (e.g., \"gpt-4o\", \"Composer\", \"Claude Sonnet 4\", \"Claude Opus\", \"Gemini 2.5\", \"Cascade\", \"Grok 4.1\", \"Copilot\", \"Devin\", and many others). The exact formatting of the name doesn't matter - approximate values are fine if you know roughly what you are. Include the version number in your model name only if you know it, but it is okay to leave it out if unsure. If you don't know your model name, omit this field entirely.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "llm_provider": {
                "description": "Optional. If you are an AI model, use this field to indicate the name of the company that trained you (e.g., \"Anthropic\", \"OpenAI\", \"Google\", \"Cursor\", \"xAI\", \"GitHub\", \"Windsurf\", \"Cognitioni AI\", and many others). The exact formatting doesn't matter - approximate values are fine. If you don't know your provider, avoid guessing and omit this field.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "model": {
                "description": "Choose a reranking model:\n- \"cohere-rerank-3.5\" is Cohere's leading reranking model, balancing performance\nand latency for a wide range of enterprise search applications.\n- \"bge-reranker-v2-m3\" is a high-performance, multilingual reranking model that\nworks well on messy data and short queries expected to return medium-length\npassages of text (1-2 paragraphs).\n- \"pinecone-rerank-v0\" is a state of the art reranking model that out-performs\ncompetitors on widely accepted benchmarks. It can handle chunks up to 512 tokens\n(1-2 paragraphs).",
                "enum": [
                  "cohere-rerank-3.5",
                  "bge-reranker-v2-m3",
                  "pinecone-rerank-v0"
                ],
                "type": "string"
              },
              "options": {
                "properties": {
                  "rankFields": {
                    "description": "The fields to rerank on. This should only be included if the documents\n        are records. The \"bge-reranker-v2-m3\" and \"pinecone-rerank-v0\" models\n        support only a single rerank field. \"cohere-rerank-3.5\" supports\n        multiple rerank fields.",
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "topN": {
                    "description": "The number of results to return after reranking.",
                    "type": "number"
                  }
                },
                "required": [
                  "topN"
                ],
                "type": "object"
              },
              "query": {
                "description": "The query to rerank documents against.",
                "type": "string"
              }
            },
            "required": [
              "model",
              "query",
              "documents"
            ],
            "type": "object"
          },
          "declared": {
            "read_only": "true",
            "destructive": "unknown",
            "idempotent": "false",
            "open_world": "unknown"
          },
          "effects": {
            "kind": "read",
            "destructive": "false",
            "external": "unknown"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "read",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:b4ed05894ee48ab8e9840026af18dca5856f86072c862300b9f7972f707053ef"
        },
        {
          "id": "mcp:pinecone-mcp/search-docs",
          "name": "search-docs",
          "title": "Search Pinecone Documentation",
          "description": "Search the official Pinecone documentation for relevant\ninformation. Use this before writing Pinecone code or explaining Pinecone\nbehavior, rather than relying on assumptions.",
          "source": {
            "type": "mcp",
            "server": "pinecone-mcp",
            "operation": "search-docs"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "query": {
                "description": "The text to search for.",
                "type": "string"
              }
            },
            "required": [
              "query"
            ],
            "type": "object"
          },
          "declared": {
            "read_only": "true",
            "destructive": "unknown",
            "idempotent": "false",
            "open_world": "unknown"
          },
          "effects": {
            "kind": "read",
            "destructive": "false",
            "external": "unknown"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "read",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:cca5c0a1c07682a723c1497d885f1215cfeb1ca0f0417119e8f0ce7da8b71654"
        },
        {
          "id": "mcp:pinecone-mcp/search-records",
          "name": "search-records",
          "title": "Search Records",
          "description": "Search an index for records that are semantically similar\nto the query text. Only works with integrated-inference indexes (e.g. created\nwith create-index-for-model), which embed the query automatically; it fails on\nstandard indexes — use describe-index to check the index type. Returns hits\nwith \"_id\", \"_score\", and the record's stored \"fields\". Newly upserted records can take a few seconds\nto be indexed and become visible to search results and index stats; if recent\ndata is missing, wait briefly and retry.",
          "source": {
            "type": "mcp",
            "server": "pinecone-mcp",
            "operation": "search-records"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "llm_model": {
                "description": "Optional. If you are an AI model, use this field to specify your name (e.g., \"gpt-4o\", \"Composer\", \"Claude Sonnet 4\", \"Claude Opus\", \"Gemini 2.5\", \"Cascade\", \"Grok 4.1\", \"Copilot\", \"Devin\", and many others). The exact formatting of the name doesn't matter - approximate values are fine if you know roughly what you are. Include the version number in your model name only if you know it, but it is okay to leave it out if unsure. If you don't know your model name, omit this field entirely.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "llm_provider": {
                "description": "Optional. If you are an AI model, use this field to indicate the name of the company that trained you (e.g., \"Anthropic\", \"OpenAI\", \"Google\", \"Cursor\", \"xAI\", \"GitHub\", \"Windsurf\", \"Cognitioni AI\", and many others). The exact formatting doesn't matter - approximate values are fine. If you don't know your provider, avoid guessing and omit this field.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "name": {
                "description": "The index to search.",
                "type": "string"
              },
              "namespace": {
                "description": "The namespace to search.",
                "type": "string"
              },
              "query": {
                "description": "A query to search for records.",
                "properties": {
                  "filter": {
                    "additionalProperties": {},
                    "description": "A filter can be used to narrow down results. Use the syntax of\n        MongoDB's query and projection operators: $eq, $ne, $gt, $gte, $lt,\n        $lte, $in, $nin, $exists, $and, $or. Make sure the records in the index\n        contain the fields that you are filtering on. To discover which fields\n        exist, run a search without a filter and inspect the \"fields\" of the\n        returned hits. Filtering on a field that records do not contain\n        returns no results.",
                    "properties": {},
                    "type": "object"
                  },
                  "inputs": {
                    "properties": {
                      "text": {
                        "description": "The text to search for.",
                        "type": "string"
                      }
                    },
                    "required": [
                      "text"
                    ],
                    "type": "object"
                  },
                  "topK": {
                    "description": "The number of results to return. 10 is a reasonable default; use a\n      larger value (e.g. 50) when reranking, so the reranker has more\n      candidates to choose from. Very large values increase latency and\n      response size.",
                    "type": "number"
                  }
                },
                "required": [
                  "topK",
                  "inputs"
                ],
                "type": "object"
              },
              "rerank": {
                "description": "Reranking can help determine which of the returned records are most\n  relevant. When reranking, use a \"query\" with a \"topK\" that returns more\n  results than you need; then use \"rerank\" to select the most relevant\n  \"topN\" results.",
                "properties": {
                  "model": {
                    "description": "Choose a reranking model:\n- \"cohere-rerank-3.5\" is Cohere's leading reranking model, balancing performance\nand latency for a wide range of enterprise search applications.\n- \"bge-reranker-v2-m3\" is a high-performance, multilingual reranking model that\nworks well on messy data and short queries expected to return medium-length\npassages of text (1-2 paragraphs).\n- \"pinecone-rerank-v0\" is a state of the art reranking model that out-performs\ncompetitors on widely accepted benchmarks. It can handle chunks up to 512 tokens\n(1-2 paragraphs).",
                    "enum": [
                      "cohere-rerank-3.5",
                      "bge-reranker-v2-m3",
                      "pinecone-rerank-v0"
                    ],
                    "type": "string"
                  },
                  "query": {
                    "description": "An optional query to rerank documents against. If not specified, the\n      same query will be used for both the initial search and the reranking.",
                    "type": "string"
                  },
                  "rankFields": {
                    "description": "The fields to rerank on. This should include the field name specified\n    in the index's \"fieldMap\". The \"bge-reranker-v2-m3\" and\n    \"pinecone-rerank-v0\" models support only a single rerank field.\n    \"cohere-rerank-3.5\" supports multiple rerank fields.",
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "topN": {
                    "description": "The number of results to return after reranking. Must be less than or\n      equal to the value of \"query.topK\".",
                    "type": "number"
                  }
                },
                "required": [
                  "model",
                  "rankFields"
                ],
                "type": "object"
              }
            },
            "required": [
              "name",
              "namespace",
              "query"
            ],
            "type": "object"
          },
          "declared": {
            "read_only": "true",
            "destructive": "unknown",
            "idempotent": "false",
            "open_world": "unknown"
          },
          "effects": {
            "kind": "read",
            "destructive": "false",
            "external": "unknown"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "true"
          },
          "effect_assessment": {
            "kind": "read",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:015dec09881a7deef04c06635cfb8a35e7950fc182611b05d105d68230e5ac98"
        },
        {
          "id": "mcp:pinecone-mcp/upsert-records",
          "name": "upsert-records",
          "title": "Upsert Records",
          "description": "Insert or update records in an integrated Pinecone index.\nText in the field named by the index's \"fieldMap\" is embedded automatically —\ncall describe-index first to confirm that field name. Records with an existing\n\"id\" are overwritten. Newly upserted records can take a few seconds\nto be indexed and become visible to search results and index stats; if recent\ndata is missing, wait briefly and retry.",
          "source": {
            "type": "mcp",
            "server": "pinecone-mcp",
            "operation": "upsert-records"
          },
          "input_schema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "llm_model": {
                "description": "Optional. If you are an AI model, use this field to specify your name (e.g., \"gpt-4o\", \"Composer\", \"Claude Sonnet 4\", \"Claude Opus\", \"Gemini 2.5\", \"Cascade\", \"Grok 4.1\", \"Copilot\", \"Devin\", and many others). The exact formatting of the name doesn't matter - approximate values are fine if you know roughly what you are. Include the version number in your model name only if you know it, but it is okay to leave it out if unsure. If you don't know your model name, omit this field entirely.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "llm_provider": {
                "description": "Optional. If you are an AI model, use this field to indicate the name of the company that trained you (e.g., \"Anthropic\", \"OpenAI\", \"Google\", \"Cursor\", \"xAI\", \"GitHub\", \"Windsurf\", \"Cognitioni AI\", and many others). The exact formatting doesn't matter - approximate values are fine. If you don't know your provider, avoid guessing and omit this field.  **Do not prompt the user for this.** This value is used to track usage analytics. ",
                "type": "string"
              },
              "name": {
                "description": "The index to upsert into.",
                "type": "string"
              },
              "namespace": {
                "description": "The namespace to upsert into.",
                "type": "string"
              },
              "records": {
                "description": "A set of records to upsert into the index. Use a consistent schema for all\n  records in the index.",
                "items": {
                  "additionalProperties": {
                    "description": "A field value. Must be a string, number, boolean, or array of strings."
                  },
                  "description": "A record to upsert. Must have an \"id\" or \"_id\" field and contain text in\n    the field specified by the index's \"fieldMap\".",
                  "propertyNames": {
                    "type": "string"
                  },
                  "type": "object"
                },
                "type": "array"
              }
            },
            "required": [
              "name",
              "namespace",
              "records"
            ],
            "type": "object"
          },
          "declared": {
            "read_only": "false",
            "destructive": "true",
            "idempotent": "true",
            "open_world": "unknown"
          },
          "effects": {
            "kind": "write",
            "destructive": "true",
            "external": "unknown"
          },
          "safety": {
            "idempotent": "true",
            "retry_safe": "unknown"
          },
          "effect_assessment": {
            "kind": "destructive",
            "basis": "declared"
          },
          "metadata": {
            "mcp.annotations": "present"
          },
          "fingerprint": "sha256:1257eda37f94e105bfee9e1d5fd379546032525fbdba53e7b87953b7fd6e2e08"
        }
      ],
      "discovery_order": [
        "mcp:pinecone-mcp/search-docs",
        "mcp:pinecone-mcp/list-indexes",
        "mcp:pinecone-mcp/describe-index",
        "mcp:pinecone-mcp/describe-index-stats",
        "mcp:pinecone-mcp/create-index-for-model",
        "mcp:pinecone-mcp/upsert-records",
        "mcp:pinecone-mcp/search-records",
        "mcp:pinecone-mcp/rerank-documents",
        "mcp:pinecone-mcp/cascading-search"
      ],
      "fingerprint": "sha256:7db05adbc00fd3a8defeb737029984bf1564018031d3b8585a523c1dc89f8195"
    },
    "summary": {
      "total": 9,
      "read_only": 7,
      "potential_writes": 2,
      "destructive": 1,
      "unknown_effects": 0,
      "retry_safe": 8
    },
    "schema_stats": {
      "mcp:pinecone-mcp/cascading-search": {
        "input": {
          "properties": 5,
          "required": 3,
          "total_properties": 15,
          "nested_objects": 5,
          "arrays": 2,
          "max_depth": 3,
          "combinators": 0,
          "refs": 0,
          "complexity": 22
        }
      },
      "mcp:pinecone-mcp/create-index-for-model": {
        "input": {
          "properties": 6,
          "required": 2,
          "total_properties": 9,
          "nested_objects": 2,
          "arrays": 0,
          "max_depth": 3,
          "combinators": 0,
          "refs": 0,
          "complexity": 11
        }
      },
      "mcp:pinecone-mcp/describe-index": {
        "input": {
          "properties": 3,
          "required": 1,
          "total_properties": 3,
          "nested_objects": 0,
          "arrays": 0,
          "max_depth": 1,
          "combinators": 0,
          "refs": 0,
          "complexity": 3
        }
      },
      "mcp:pinecone-mcp/describe-index-stats": {
        "input": {
          "properties": 3,
          "required": 1,
          "total_properties": 3,
          "nested_objects": 0,
          "arrays": 0,
          "max_depth": 1,
          "combinators": 0,
          "refs": 0,
          "complexity": 3
        }
      },
      "mcp:pinecone-mcp/list-indexes": {
        "input": {
          "properties": 2,
          "required": 0,
          "total_properties": 2,
          "nested_objects": 0,
          "arrays": 0,
          "max_depth": 1,
          "combinators": 0,
          "refs": 0,
          "complexity": 2
        }
      },
      "mcp:pinecone-mcp/rerank-documents": {
        "input": {
          "properties": 6,
          "required": 3,
          "total_properties": 8,
          "nested_objects": 1,
          "arrays": 1,
          "max_depth": 2,
          "combinators": 0,
          "refs": 0,
          "complexity": 10
        }
      },
      "mcp:pinecone-mcp/search-docs": {
        "input": {
          "properties": 1,
          "required": 1,
          "total_properties": 1,
          "nested_objects": 0,
          "arrays": 0,
          "max_depth": 1,
          "combinators": 0,
          "refs": 0,
          "complexity": 1
        }
      },
      "mcp:pinecone-mcp/search-records": {
        "input": {
          "properties": 6,
          "required": 3,
          "total_properties": 14,
          "nested_objects": 4,
          "arrays": 1,
          "max_depth": 3,
          "combinators": 0,
          "refs": 0,
          "complexity": 19
        }
      },
      "mcp:pinecone-mcp/upsert-records": {
        "input": {
          "properties": 5,
          "required": 3,
          "total_properties": 5,
          "nested_objects": 1,
          "arrays": 1,
          "max_depth": 1,
          "combinators": 0,
          "refs": 0,
          "complexity": 7
        }
      }
    }
  },
  "source": {
    "registry": "npm",
    "package": "@pinecone-database/mcp",
    "version": "0.3.0",
    "published_at": "2026-08-07T15:38:25.631Z",
    "integrity": "sha512-hC8nc4VgNi6wbXkergDP3q/8zHnhx67HtuL/lNPtvnlfCmIGNTMEYXX6hkWvvqhHliDTwK+Y8PnIHR3IBRkSVw==",
    "repository": "https://github.com/pinecone-io/pinecone-mcp"
  },
  "analyzer": {
    "name": "modelara",
    "version": "v0.1.8",
    "policy_version": null
  },
  "capability_hash_version": 2,
  "capability_hashes": {
    "pinecone:tool:cascading-search": {
      "description": "sha256:952329bf39e5845ee9277e2488767298583426579928d4eefb981b347028bb14",
      "input_schema": "sha256:c9cfa1b4ab7bfe6f7c0c0ec754daa5a09590626331f1ecb6123845b333fb37a4",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:33a64ebec3c5cc84b0e8d062f35e93c2c8a0b627d1f86c171622e95027840372"
    },
    "pinecone:tool:create-index-for-model": {
      "description": "sha256:8ffc3a71bea24389ea8a03f0d94c173949150447a6a9fcbbb601d0acf8bacbb7",
      "input_schema": "sha256:bdb3578001b509cec054ef02c890e2d53a27e0987984b193f9bb4b3022b1f407",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:6a8091492a01f36c9e55d516a1f2ddc9526e68675eab7e19500932b5b5bbd13a"
    },
    "pinecone:tool:describe-index": {
      "description": "sha256:a76c5da144207725bcd0124205ae466a87fa3ee5c206085d520dc443c8edc99d",
      "input_schema": "sha256:436a6025bab7d21d8332405f97a62bb84638e60314635d3da852f2ae8388128f",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:2318d98df54611bf8ce5c097847fd3e30e82e34c8dc36ff56701a293cd5b4afb"
    },
    "pinecone:tool:describe-index-stats": {
      "description": "sha256:5dd7826e075a67a02423b0056a48a67aeed9b215b787ae89dfb65ff9fc0872f2",
      "input_schema": "sha256:436a6025bab7d21d8332405f97a62bb84638e60314635d3da852f2ae8388128f",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:b0ca5f18785f663126170b36d6433cbcdfad23ca30d712d8cb53bd3e4c7ef7a8"
    },
    "pinecone:tool:list-indexes": {
      "description": "sha256:6ab7a9e38f7b0d3c65df0a3f32d541b5464984d5c06488e3a39443278d9d2ff8",
      "input_schema": "sha256:a889f35479a8ffa09ddcb31ce9d8335a8c4fa6cefdcb668719c687a1990435e6",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:bfa20e95b5293e161a8d48cefecad1a95d97bb6cd761f89be03a9591de9abe96"
    },
    "pinecone:tool:rerank-documents": {
      "description": "sha256:61b606e3c5645baee2da335196c89b894dba1b84c987880ef8c1cf9dd9cdc560",
      "input_schema": "sha256:a7010f8f08acf795f1996ed8405623c4f74d914012998b44d790377d1275e8e9",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:38e26ebf469985f930f2e2eda1180169c54f2288fec3cacd4df0b91a618000c8"
    },
    "pinecone:tool:search-docs": {
      "description": "sha256:4dfe898c7658f0cbaacb42a02a16a482099ae1da0ccdcdc2e0b2f8de912c56fa",
      "input_schema": "sha256:98375aa0bb0e35b7fe98b03af35cf63e6e434efb2c0b95b67b35f5fa6ab8a274",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:5f9072dc9b7b8fc700665d6e5f32d7cc88b43d4a7c0cf1894dfb64d22c960d29"
    },
    "pinecone:tool:search-records": {
      "description": "sha256:8ee5ce1199f6552803244963d6d7963208ef0bdad3b3d0cd19734847ee4d9092",
      "input_schema": "sha256:c5e4b64c08d54c9c93a2fff2f579c634ffaf851b72bb7820cf478895bcf7a7c6",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:60b4c26707462de81a091017493f76044f6b62e6ea5e8f4f9c886595c6aad807"
    },
    "pinecone:tool:upsert-records": {
      "description": "sha256:11868f9b0bf9fac3f9d21a7f76874a734a99edcb087b5b45a196732e5ad169d5",
      "input_schema": "sha256:2da74df95cfe3cf04a4d40bd900864b99cf60ab81b71d9899f19eac9246f3b8b",
      "output_schema": "sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1",
      "interface": "sha256:b025a4b01d937e4c3789561d0591b8c69b469034315fd3eda329186a917c026c"
    }
  }
}
