{"id":"0db649f9-f9b9-479b-8119-00b345e5cc2f","shortId":"3abjat","kind":"skill","title":"pinecone-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 `pinecone-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 command 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":["pinecone","query","skills","pinecone-io","agent-skills","agents","semantic-search","skills-sh"],"capabilities":["skill","source-pinecone-io","skill-pinecone-query","topic-agent-skills","topic-agents","topic-pinecone","topic-semantic-search","topic-skills-sh"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/pinecone-io/skills/pinecone-query","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add pinecone-io/skills","source_repo":"https://github.com/pinecone-io/skills","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 12 github stars · SKILL.md body (4,197 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-18T19:07:27.333Z","embedding":null,"createdAt":"2026-05-18T19:07:27.333Z","updatedAt":"2026-05-18T19:07:27.333Z","lastSeenAt":"2026-05-18T19:07:27.333Z","tsv":"'/?sessiontype=signup':138,466 '/query':519 '1':108,316 '2':121,357 '3':139,416 '4':431 'access':281,471 'add':503 'advanc':37,199 'agent':489 'api':123,133,297,455,494,505,553 'app.pinecone.io':137,465 'app.pinecone.io/?sessiontype=signup':136,464 'argument':363,426,578,605,621 'ask':382,401,478,689 'attempt':543 'automat':96 'avail':120,275,379,399,569,656 'built':23,85 'built-in':22,84 'bulk':207 'call':417 'capabl':566 'case':234 'check':115,294 'choos':386 'clarifi':694 'clear':440 'cli':42,173,238 'coher':219 'command':520 'complet':612 'configur':114,293,664 'convert':97 'count':675 'current':225 'custom':192 'data':539 'describ':374,410,598,660,668 'describe-index':373,409,597,659 'describe-index-stat':667 'direct':303 'display':434 'document':309,680,683 'e.g':150,593,622 'e5':31,153 'emb':158,535 'embed':26,88,101,148,185,215,532,560 'english':163 'env':512 'environ':125,299 'error':472,629 'export':492 'fetch':202 'field':444 'file':513 'filter':648 'format':432 'free':132,461 'gather':425 'get':130,398,459,469,662,671 'given':643 'guid':600 'help':314 'highlight':445 'host':530 'huggingfac':218,559 'id':204,448 'ide':487,499 'import':12,266,514 'improv':355 'includ':443,673 'index':6,19,20,35,56,81,82,105,140,145,178,182,210,229,260,330,337,346,367,375,396,400,411,527,547,596,599,624,644,653,658,661,663,669 'inform':282,696 'inherit':502 'input':321 'instead':44,175 'integr':5,18,55,80,144,184,228,259,526 'interact':603,692 'invalid':615 'key':124,134,298,456,462,474,495,498,506,509 'languag':59 'larg':32,154 'like':28,476 'limit':221 'list':205,395,595,652,654 'list-index':394,594,651 'llama':156 'llama-text-embed-v2':155 'mcp':11,65,94,110,117,220,224,245,272,277,288,307,574,589 'metadata':452,647 'miss':477,580,695 'model':27,89,149,186,216,351,533,554,561,688 'moment':517 'multilingu':30,152 'multilingual-e5-large':29,151 'must':112,127,141 'name':333,368 'namespac':340,343,380,413,626,666,677 'natur':58 'need':188,198,290,415,592,698 'nonexist':623 'omit':361 'one':406 'openai':217,557 'oper':39,201,208 'option':341,348,633,646 'p':46 'pars':317 'parti':214,552 'perform':428 'pick':405 'pinecon':2,10,25,47,54,64,87,109,122,147,161,223,237,244,258,271,287,296,313,336,454,493,504,531,573,588,657 'pinecone-help':312 'pinecone-queri':1 'pinecone-sparse-english-v0':160 'prerequisit':106 'proceed':268 'prompt':581 'provid':74,370,392,618 'queri':3,4,48,61,79,92,190,264,323,390,545 'readabl':441 'record':52,249,254,421,638,640,674 'refer':635 'relev':356,451 'remind':562 'requir':45,107,324,331,362,458,577 'rerank':347,350,650,679,681,687 'rerank-docu':678 'restart':485 'result':437 'retriev':378 'return':436,682 'score':449 'search':50,103,248,252,328,339,420,430,537,609,637,639 'search-record':247,419,636 'select':606 'server':66,95,111,289,575 'session':490 'set':129,302,482 'setup':308 'shell':501 'simpl':76 'skill':14,43,49,70,73,170,174,239,315 'skill-pinecone-query' 'source-pinecone-io' 'spars':162 'specifi':257,686 'standard':34,181 'stat':670,672 'suggest':631 'suppli':585 'support':227 'surfac':627 'tabl':442 'termin':491 'text':8,60,91,99,157,196,263,326 'third':213,551 'third-parti':212 'tool':118,250,273,278,376,422,590,634 'topic-agent-skills' 'topic-agents' 'topic-pinecone' 'topic-semantic-search' 'topic-skills-sh' 'troubleshoot':453 'use':7,40,57,90,146,168,171,211,233,235,261,353,371,393,408,524,529,549,587,684 'user':284,319,360,384,403,480,542,583,602,691 'util':243 'v0':164 'v2':159 'valid':632 'valu':194,616 'variabl':126,300 'vector':38,193,200,206 'verifi':269 'via':62 'way':77 'within':255,344 'without':500 'work':16,242 'workflow':265 'yet':570 'your-key':496,507","prices":[{"id":"05d68a52-2b42-4195-a922-bb6c8bddb981","listingId":"0db649f9-f9b9-479b-8119-00b345e5cc2f","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"pinecone-io","category":"skills","install_from":"skills.sh"},"createdAt":"2026-05-18T19:07:27.333Z"}],"sources":[{"listingId":"0db649f9-f9b9-479b-8119-00b345e5cc2f","source":"github","sourceId":"pinecone-io/skills/pinecone-query","sourceUrl":"https://github.com/pinecone-io/skills/tree/main/skills/pinecone-query","isPrimary":false,"firstSeenAt":"2026-05-18T19:07:27.333Z","lastSeenAt":"2026-05-18T19:07:27.333Z"}],"details":{"listingId":"0db649f9-f9b9-479b-8119-00b345e5cc2f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"pinecone-io","slug":"pinecone-query","github":{"repo":"pinecone-io/skills","stars":12,"topics":["agent-skills","agents","pinecone","retrieval-augmented-generation","semantic-search","skills-sh"],"license":"mit","html_url":"https://github.com/pinecone-io/skills","pushed_at":"2026-05-07T04:32:27Z","description":"Pinecone's official Agent Skills library, for use with agentic IDEs such as Cursor, Github Copilot, Antigravity, Gemini CLI and more.","skill_md_sha":"f73abffaace04cfefd36c8a87b33a9a610688349","skill_md_path":"skills/pinecone-query/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/pinecone-io/skills/tree/main/skills/pinecone-query"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"pinecone-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/skills/pinecone-query"},"updatedAt":"2026-05-18T19:07:27.333Z"}}