Pinecone Developer

pinecone-io

Manage Pinecone indexes and upsert, search, and rerank records (integrated inference), plus search the Pinecone docs, via the official Pinecone Developer MCP server.

Installs: —
Namespace: pinecone
Version: >=0.2.0 <0.3.0
Last attach: reviewed1 months ago

Add to your mcp.json

{
  "mcpServers": {
    "pinecone": {
      "command": "npx",
      "args": [
        "-y",
        "@pinecone-database/mcp"
      ],
      "env": {
        "PINECONE_API_KEY": "<PINECONE_API_KEY>"
      }
    }
  }
}

Open in VS CodeDon't have it? Install FrootAI for VS Code

Attach in a FrootAI play (fai-manifest)

mcp_scope:
  attached:
    - pinecone

Authentication

api-key

generate an API key in the Pinecone console (app.pinecone.io) and set PINECONE_API_KEY.

Required credential: PINECONE_API_KEY

Environment variables

Variable	Required	Auth mode	Description
PINECONE_API_KEY	yes	api-key	Pinecone API key from the console (app.pinecone.io). Required to list/create/upsert/query indexes; without it only docs search works. Pass via env, never inline in args (doctrine #6).

Sample tools

pinecone.search-docs
Search the official Pinecone documentation.
pinecone.list-indexes
List all Pinecone indexes.
pinecone.describe-index
Describe the configuration of an index.
pinecone.describe-index-stats
Get statistics about an index, including record count and namespaces.
pinecone.create-index-for-model
Create a new index that uses an integrated inference model to embed text.
pinecone.upsert-records
Insert or update records in an index with integrated inference.
pinecone.search-records
Search records in an index by text query, with metadata filtering and reranking.
pinecone.rerank-documents
Rerank a collection of records or text documents with a reranking model.

Used in recipes

FAI cookbook recipes that attach pinecone.

Destructive-action audit

No destructive tools — audited read-only

Destructive-action audit (X2.18): no destructive tools — the tools list/describe/search/upsert/rerank records and create indexes; none delete indexes or records, so destructive_tools is empty.

Known limitations

Requires a PINECONE_API_KEY for index management and queries; without a key the server can still search Pinecone documentation but cannot list, create, upsert, or search your indexes.
Only Pinecone indexes with integrated inference are supported — assistants, indexes without integrated inference, standalone embeddings, and standalone vector search are not exposed; create a compatible index with create-index-for-model.
Runs via `npx -y @pinecone-database/mcp` and needs Node.js v18+ with npx on PATH; it reaches the Pinecone control/data plane at api.pinecone.io, so outbound network access is required.

Spec contributors

Maintainers who landed commits onmcp-specs/pinecone.json.

pspsbali

Freshness

When this spec was last reviewed by a maintainer and last machine-validated against the live server.

Spec last reviewed: 1 months ago(2026-06-25)
Auto-validated: never