A Model Context Protocol (MCP) server that provides semantic search over Pinecone vector databases using hybrid search (dense + sparse) with reranking.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"pinecone-read-only-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Pinecone Read-Only MCP [](https://pypi.org/project/pinecone-read-only-mcp/) [](https://pypi.org/project/pinecone-read-only-mcp/) [](https://opensource.org/licenses/BSL-1.0) A Model Context Protocol (MCP) server that provides semantic search over Pinecone vector databases using hybrid search (dense + sparse) with reranking. ## Features - **Hybrid Search**: Combines dense and sparse embeddings for superior recall - **Semantic Reranking**: Uses BGE reranker model for improved precision - **Dynamic Namespace Discovery**: Automatically discovers available namespaces in your Pinecone index - **Metadata Filtering**: Supports optional metadata filters for refined searches - **Fast & Optimized**: Lazy initialization, connection pooling, and efficient result merging - **Production Ready**: Input validation, error handling, and configurable logging ## Installation In a `uv` managed python project, add to dependencies by: ```bash uv add pinecone-read-only-mcp ``` Alternatively, for projects using `pip` for dependencies: ```bash pip install pinecone-read-only-mcp ``` To run the server inside your project: ```bash uv run pinecone-read-only-mcp --api-key YOUR_PINECONE_API_KEY ``` Or to run it globally in isolated environment: ```bash uvx pinecone-read-only-mcp --api-key YOUR_PINECONE_API_KEY ``` To install directly from the source: ```bash git clone https://github.com/iTinkerBell/pinecone-read-only-mcp.git cd pinecone-read-only-mcp pip install -e . ``` ## Configuration The server requires a Pinecone API key and supports the following configuration options: ### Environment Variables | Variable | Required | Default | Description | |----------|----------|---------|-------------| | `PINECONE_API_KEY` | Yes | - | Your Pinecone API key …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.