{"id":"e58fe18d-16ae-4973-b93c-9618c2a439ab","shortId":"9e4tAa","kind":"skill","title":"query","tagline":"Query integrated indexes using text with Pinecone MCP. IMPORTANT - This skill ONLY works with integrated indexes (indexes with built-in Pinecone embedding models like multilingual-e5-large). For standard indexes or advanced vector operations, use the CLI skill instead. Requires P","description":"# Pinecone Query Skill\n\nSearch for records in Pinecone integrated indexes using natural language text queries via the Pinecone MCP server.\n\n## What is this skill for?\n\nThis skill provides a simple way to query **integrated indexes** (indexes with built-in Pinecone embedding models) using text queries. The MCP server automatically converts your text into embeddings and searches the index.\n\n### Prerequisites\n\n**Required:**\n1. ✅ **Pinecone MCP server must be configured** - Check if MCP tools are available\n2. ✅ **PINECONE_API_KEY environment variable must be set** - Get a free API key at https://app.pinecone.io/?sessionType=signup\n3. ✅ **Index must be an integrated index** - Uses Pinecone embedding models (e.g., multilingual-e5-large, llama-text-embed-v2, pinecone-sparse-english-v0)\n\n### When NOT to use this skill\n\n**Use the CLI skill instead if:**\n- ❌ Your index is a standard index (no integrated embedding model)\n- ❌ You need to query with custom vector values (not text)\n- ❌ You need advanced vector operations (fetch by ID, list vectors, bulk operations)\n- ❌ Your index uses third-party embedding models (OpenAI, HuggingFace, Cohere)\n\n**MCP Limitation**: The Pinecone MCP currently only supports integrated indexes. For all other use cases, use the Pinecone CLI skill.\n\n## How it works\n\nUtilize Pinecone MCP's `search-records` tool to search for records within a specified Pinecone integrated index using a text query.\n\n## Workflow\n\n**IMPORTANT: Before proceeding, verify the Pinecone MCP tools are available.** If MCP tools are not accessible:\n- Inform the user that the Pinecone MCP server needs to be configured\n- Check if `PINECONE_API_KEY` environment variable is set\n- Direct them to the MCP setup documentation or the `help` skill\n\n1. Parse the user's input for:\n   - `query` (required): The text to search for.\n   - `index` (required): The name of the Pinecone index to search.\n   - `namespace` (optional): The namespace within the index.\n   - `reranker` (optional): The reranking model to use for improved relevance.\n\n2. If the user omits required arguments:\n   - If only the index name is provided, use the `describe-index` tool to retrieve available namespaces and ask the user to choose.\n   - If only a query is provided, use `list-indexes` to get available indexes, ask the user to pick one, then use `describe-index` for namespaces if needed.\n\n3. Call the `search-records` tool with the gathered arguments to perform the search.\n\n4. Format and display the returned results in a clear, readable table including field highlights (such as ID, score, and relevant metadata).\n\n---\n\n## Troubleshooting\n\n**`PINECONE_API_KEY` is required.** Get a free key at https://app.pinecone.io/?sessionType=signup\n\nIf you get an access error, the key is likely missing. Ask the user to set it and restart their IDE or agent session:\n- Terminal: `export PINECONE_API_KEY=\"your-key\"`\n- IDE without shell inheritance: add `PINECONE_API_KEY=your-key` to a `.env` file\n\n**IMPORTANT** At the moment, the query action can only be used with integrated indexes, which use hosted Pinecone embedding models to embed and search for data.\nIf a user attempts to query an index that uses a third party API model such as OpenAI, or HuggingFace embedding models, remind them that this capability is not available yet\nwith the Pinecone MCP server.\n\n- If required arguments are missing, prompt the user to supply them, using Pinecone MCP tools as needed (e.g., `list-indexes`, `describe-index`).\n- Guide the user interactively through argument selection until the search can be completed.\n- If an invalid value is provided for any argument (e.g., nonexistent index or namespace), surface the error and suggest valid options.\n\n## Tools Reference\n\n- `search-records`: Search records in a given index with optional metadata filtering and reranking.\n- `list-indexes`: List all available Pinecone indexes.\n- `describe-index`: Get index configuration and namespaces.\n- `describe-index-stats`: Get stats including record counts and namespaces.\n- `rerank-documents`: Rerank returned documents using a specified reranking model.\n- Ask the user interactively to clarify missing information when needed.\n\n---","tags":["query","gemini","cli","extension","pinecone-io","agent-skills","agentic-ides","gemini-cli","gemini-cli-extension","pinecone","semantic-search","vector-search"],"capabilities":["skill","source-pinecone-io","skill-query","topic-agent-skills","topic-agentic-ides","topic-gemini-cli","topic-gemini-cli-extension","topic-pinecone","topic-semantic-search","topic-vector-search"],"categories":["gemini-cli-extension"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/pinecone-io/gemini-cli-extension/query","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add pinecone-io/gemini-cli-extension","source_repo":"https://github.com/pinecone-io/gemini-cli-extension","install_from":"skills.sh"}},"qualityScore":"0.461","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 23 github stars · SKILL.md body (4,186 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-01T01:02:18.327Z","embedding":null,"createdAt":"2026-04-18T22:24:47.761Z","updatedAt":"2026-05-01T01:02:18.327Z","lastSeenAt":"2026-05-01T01:02:18.327Z","tsv":"'/?sessiontype=signup':136,462 '1':106,312 '2':119,353 '3':137,412 '4':427 'access':279,467 'action':516 'add':499 'advanc':35,197 'agent':485 'api':121,131,295,451,490,501,549 'app.pinecone.io':135,461 'app.pinecone.io/?sessiontype=signup':134,460 'argument':359,422,574,601,617 'ask':378,397,474,685 'attempt':539 'automat':94 'avail':118,273,375,395,565,652 'built':21,83 'built-in':20,82 'bulk':205 'call':413 'capabl':562 'case':232 'check':113,292 'choos':382 'clarifi':690 'clear':436 'cli':40,171,236 'coher':217 'complet':608 'configur':112,291,660 'convert':95 'count':671 'current':223 'custom':190 'data':535 'describ':370,406,594,656,664 'describe-index':369,405,593,655 'describe-index-stat':663 'direct':301 'display':430 'document':307,676,679 'e.g':148,589,618 'e5':29,151 'emb':156,531 'embed':24,86,99,146,183,213,528,556 'english':161 'env':508 'environ':123,297 'error':468,625 'export':488 'fetch':200 'field':440 'file':509 'filter':644 'format':428 'free':130,457 'gather':421 'get':128,394,455,465,658,667 'given':639 'guid':596 'help':310 'highlight':441 'host':526 'huggingfac':216,555 'id':202,444 'ide':483,495 'import':10,264,510 'improv':351 'includ':439,669 'index':4,17,18,33,54,79,80,103,138,143,176,180,208,227,258,326,333,342,363,371,392,396,407,523,543,592,595,620,640,649,654,657,659,665 'inform':280,692 'inherit':498 'input':317 'instead':42,173 'integr':3,16,53,78,142,182,226,257,522 'interact':599,688 'invalid':611 'key':122,132,296,452,458,470,491,494,502,505 'languag':57 'larg':30,152 'like':26,472 'limit':219 'list':203,391,591,648,650 'list-index':390,590,647 'llama':154 'llama-text-embed-v2':153 'mcp':9,63,92,108,115,218,222,243,270,275,286,305,570,585 'metadata':448,643 'miss':473,576,691 'model':25,87,147,184,214,347,529,550,557,684 'moment':513 'multilingu':28,150 'multilingual-e5-large':27,149 'must':110,125,139 'name':329,364 'namespac':336,339,376,409,622,662,673 'natur':56 'need':186,196,288,411,588,694 'nonexist':619 'omit':357 'one':402 'openai':215,553 'oper':37,199,206 'option':337,344,629,642 'p':44 'pars':313 'parti':212,548 'perform':424 'pick':401 'pinecon':8,23,45,52,62,85,107,120,145,159,221,235,242,256,269,285,294,332,450,489,500,527,569,584,653 'pinecone-sparse-english-v0':158 'prerequisit':104 'proceed':266 'prompt':577 'provid':72,366,388,614 'queri':1,2,46,59,77,90,188,262,319,386,515,541 'readabl':437 'record':50,247,252,417,634,636,670 'refer':631 'relev':352,447 'remind':558 'requir':43,105,320,327,358,454,573 'rerank':343,346,646,675,677,683 'rerank-docu':674 'restart':481 'result':433 'retriev':374 'return':432,678 'score':445 'search':48,101,246,250,324,335,416,426,533,605,633,635 'search-record':245,415,632 'select':602 'server':64,93,109,287,571 'session':486 'set':127,300,478 'setup':306 'shell':497 'simpl':74 'skill':12,41,47,68,71,168,172,237,311 'skill-query' 'source-pinecone-io' 'spars':160 'specifi':255,682 'standard':32,179 'stat':666,668 'suggest':627 'suppli':581 'support':225 'surfac':623 'tabl':438 'termin':487 'text':6,58,89,97,155,194,261,322 'third':211,547 'third-parti':210 'tool':116,248,271,276,372,418,586,630 'topic-agent-skills' 'topic-agentic-ides' 'topic-gemini-cli' 'topic-gemini-cli-extension' 'topic-pinecone' 'topic-semantic-search' 'topic-vector-search' 'troubleshoot':449 'use':5,38,55,88,144,166,169,209,231,233,259,349,367,389,404,520,525,545,583,680 'user':282,315,356,380,399,476,538,579,598,687 'util':241 'v0':162 'v2':157 'valid':628 'valu':192,612 'variabl':124,298 'vector':36,191,198,204 'verifi':267 'via':60 'way':75 'within':253,340 'without':496 'work':14,240 'workflow':263 'yet':566 'your-key':492,503","prices":[{"id":"09a2a47d-7ec3-4309-a64b-2f5db107f757","listingId":"e58fe18d-16ae-4973-b93c-9618c2a439ab","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"pinecone-io","category":"gemini-cli-extension","install_from":"skills.sh"},"createdAt":"2026-04-18T22:24:47.761Z"}],"sources":[{"listingId":"e58fe18d-16ae-4973-b93c-9618c2a439ab","source":"github","sourceId":"pinecone-io/gemini-cli-extension/query","sourceUrl":"https://github.com/pinecone-io/gemini-cli-extension/tree/main/skills/query","isPrimary":false,"firstSeenAt":"2026-04-18T22:24:47.761Z","lastSeenAt":"2026-05-01T01:02:18.327Z"}],"details":{"listingId":"e58fe18d-16ae-4973-b93c-9618c2a439ab","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"pinecone-io","slug":"query","github":{"repo":"pinecone-io/gemini-cli-extension","stars":23,"topics":["agent-skills","agentic-ides","gemini-cli","gemini-cli-extension","pinecone","retrieval-augmented-generation","semantic-search","vector-search"],"license":"mit","html_url":"https://github.com/pinecone-io/gemini-cli-extension","pushed_at":"2026-04-24T19:30:56Z","description":"The official Pinecone Gemini CLI extension repo.","skill_md_sha":"1903c7bd7e27e7913646e5d23b8c59194d751d10","skill_md_path":"skills/query/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/pinecone-io/gemini-cli-extension/tree/main/skills/query"},"layout":"multi","source":"github","category":"gemini-cli-extension","frontmatter":{"name":"query","description":"Query integrated indexes using text with Pinecone MCP. IMPORTANT - This skill ONLY works with integrated indexes (indexes with built-in Pinecone embedding models like multilingual-e5-large). For standard indexes or advanced vector operations, use the CLI skill instead. Requires PINECONE_API_KEY environment variable and Pinecone MCP server to be configured."},"skills_sh_url":"https://skills.sh/pinecone-io/gemini-cli-extension/query"},"updatedAt":"2026-05-01T01:02:18.327Z"}}