The Model Context Protocol (MCP) is a standard that allows coding assistants and other AI tools to interact with platforms like Pinecone. The Pinecone Developer MCP Server allows you to connect these tools with Pinecone projects and documentation.
Model Context Protocol server for Pinecone - enables AI assistants to interact with Pinecone indexes and documentation
This MCP server is focused on improving the experience of developers working with Pinecone as part of their technology stack. It is intended for use with coding assistants. Pinecone also offers the Assistant MCP, which is designed to provide AI assistants with relevant context sourced from your knowledge base.
Setup
To configure the MCP server to access your Pinecone project, you will need to generate an API key using the console. Without an API key, your AI tool will still be able to search documentation. However, it will not be able to manage or query your indexes.
The MCP server requires Node.js v20 or later. Ensure that node and npx are available in your PATH.
Next, you will need to configure your AI assistant to use the MCP server.
Configure Cursor
To add the Pinecone MCP server to a project, create a .cursor/mcp.json file in the project root (if it doesn't already exist) and add the following configuration:
You will need to provide your Pinecone API key in the PINECONE_API_KEY environment variable.
export PINECONE_API_KEY=<your pinecone api key>
When you run gemini and press ctrl+t, pinecone should now be shown in the list of installed MCP servers.
Usage
Once configured, your AI tool will automatically make use of the MCP to interact with Pinecone. You may be prompted for permission before a tool can be used.
Example prompts
Here are some prompts you can try with your AI assistant:
"Search the Pinecone docs for information about metadata filtering"
"List all my Pinecone indexes and describe their configurations"
"Create a new index called 'my-docs' using the multilingual-e5-large model"
"Upsert these documents into my index: [paste your documents]"
"Search my index for records related to 'authentication best practices'"
"What namespaces exist in my index, and how many records are in each?"
Tools
Pinecone Developer MCP Server provides the following tools for AI assistants to use:
search-docs: Search the official Pinecone documentation.
list-indexes: Lists all Pinecone indexes.
describe-index: Describes the configuration of an index.
describe-index-stats: Provides statistics about the data in the index, including the number of records and available namespaces.
create-index-for-model: Creates a new index that uses an integrated inference model to embed text as vectors.
upsert-records: Inserts or updates records in an index with integrated inference.
search-records: Searches for records in an index based on a text query, using integrated inference for embedding. Has options for metadata filtering and reranking.
cascading-search: Searches for records across multiple indexes, deduplicating and reranking the results.
rerank-documents: Reranks a collection of records or text documents using a specialized reranking model.
Limitations
Only indexes with integrated inference are supported. Assistants, indexes without integrated inference, standalone embeddings, and vector search are not supported.
Troubleshooting
MCP server not appearing in your AI tool
Ensure Node.js v20 or later is installed: node --version
Verify npx is available in your PATH: which npx
Check that your configuration file is in the correct location and has valid JSON syntax
Restart your AI tool after making configuration changes
Check that the PINECONE_API_KEY environment variable is set correctly in your MCP configuration
Ensure there are no extra spaces or quotes around the API key value
Tools not working as expected
The MCP server only supports indexes with integrated inference. If you're trying to use a serverless index without integrated inference, you'll need to create a new index with an embedding model
Check the MCP server logs for error messages. In Cursor, view logs in Cursor Settings > MCP
Connection issues
If using a corporate network, ensure your firewall allows connections to api.pinecone.io
Try running the server manually to see detailed error output: PINECONE_API_KEY=<your-key> npx @pinecone-database/mcp
Contributing
We welcome your collaboration in improving the developer MCP experience. Please submit issues in the GitHub issue tracker. Information about contributing can be found in CONTRIBUTING.md.
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo @pinecone Database/mcp?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿@pinecone Database/mcp necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa @pinecone Database/mcp?
@pinecone Database/mcp se ejecuta localmente por stdio.
¿Cuándo se comprobó @pinecone Database/mcp por última vez?
Última comprobación: 2026-11-13. Model Context Protocol server for Pinecone - enables AI assistants to interact with Pinecone indexes and documentation