{"id":"def999a5-4d75-4937-9e64-04ee9742773e","shortId":"UrVZts","kind":"skill","title":"pinecone-mcp","tagline":"Reference for the Pinecone MCP server tools. Documents all available tools - list-indexes, describe-index, describe-index-stats, create-index-for-model, upsert-records, search-records, cascading-search, and rerank-documents. Use when an agent needs to understand what Pinecone MCP","description":"# Pinecone MCP Tools Reference\n\nThe Pinecone MCP server exposes the following tools to AI agents and IDEs. For setup and installation instructions, see the [MCP server guide](https://docs.pinecone.io/guides/operations/mcp-server#tools).\n\n> **Key Limitation:** The Pinecone MCP only supports **integrated indexes** — indexes created with a built-in Pinecone embedding model. It does not work with standard indexes using external embedding models. For those, use the Pinecone CLI.\n\n---\n\n## `list-indexes`\n\nList all indexes in the current Pinecone project.\n\n---\n\n## `describe-index`\n\nGet configuration details for a specific index — cloud, region, dimension, metric, embedding model, field map, and status.\n\n**Parameters:**\n- `name` (required) — Index name\n\n---\n\n## `describe-index-stats`\n\nGet statistics for an index including total record count and per-namespace breakdown.\n\n**Parameters:**\n- `name` (required) — Index name\n\n---\n\n## `create-index-for-model`\n\nCreate a new serverless index with an integrated embedding model. Pinecone handles embedding automatically — no external model needed.\n\n**Parameters:**\n- `name` (required) — Index name\n- `cloud` (required) — `aws`, `gcp`, or `azure`\n- `region` (required) — Cloud region (e.g. `us-east-1`)\n- `embed.model` (required) — Embedding model: `llama-text-embed-v2`, `multilingual-e5-large`, or `pinecone-sparse-english-v0`\n- `embed.fieldMap.text` (required) — The record field that contains text to embed (e.g. `chunk_text`)\n\n---\n\n## `upsert-records`\n\nInsert or update records in an integrated index. Records are automatically embedded using the index's configured model.\n\n**Parameters:**\n- `name` (required) — Index name\n- `namespace` (required) — Namespace to upsert into\n- `records` (required) — Array of records. Each record must have an `id` or `_id` field and contain the text field specified in the index's `fieldMap`. Do not nest fields under `metadata` — put them directly on the record.\n\n**Example record:**\n```json\n{ \"_id\": \"rec1\", \"chunk_text\": \"The Eiffel Tower was built in 1889.\", \"category\": \"architecture\" }\n```\n\n---\n\n## `search-records`\n\nSemantic text search against an integrated index. Pass plain text — the MCP embeds the query automatically using the index's model.\n\n**Parameters:**\n- `name` (required) — Index name\n- `namespace` (required) — Namespace to search\n- `query.inputs.text` (required) — The text query\n- `query.topK` (required) — Number of results to return\n- `query.filter` (optional) — Metadata filter using MongoDB-style operators (`$eq`, `$ne`, `$in`, `$gt`, `$gte`, `$lt`, `$lte`)\n- `rerank.model` (optional) — Reranking model: `bge-reranker-v2-m3`, `cohere-rerank-3.5`, or `pinecone-rerank-v0`\n- `rerank.rankFields` (optional) — Fields to rerank on (e.g. `[\"chunk_text\"]`)\n- `rerank.topN` (optional) — Number of results to return after reranking\n\n---\n\n## `cascading-search`\n\nSearch across multiple indexes simultaneously, then deduplicate and rerank results into a single ranked list.\n\n**Parameters:**\n- `indexes` (required) — Array of `{ name, namespace }` objects to search across\n- `query.inputs.text` (required) — The text query\n- `query.topK` (required) — Number of results to retrieve per index before reranking\n- `rerank.model` (required) — Reranking model: `bge-reranker-v2-m3`, `cohere-rerank-3.5`, or `pinecone-rerank-v0`\n- `rerank.rankFields` (required) — Fields to rerank on\n- `rerank.topN` (optional) — Final number of results to return after reranking\n\n---\n\n## `rerank-documents`\n\nRerank a set of documents or records against a query without performing a vector search first.\n\n**Parameters:**\n- `model` (required) — `bge-reranker-v2-m3`, `cohere-rerank-3.5`, or `pinecone-rerank-v0`\n- `query` (required) — The query to rerank against\n- `documents` (required) — Array of strings or records to rerank\n- `options.topN` (required) — Number of results to return\n- `options.rankFields` (optional) — If documents are records, the field(s) to rerank on","tags":["pinecone","mcp","skills","pinecone-io","agent-skills","agents","semantic-search","skills-sh"],"capabilities":["skill","source-pinecone-io","skill-pinecone-mcp","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-mcp","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 (3,947 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.255Z","embedding":null,"createdAt":"2026-05-18T19:07:27.255Z","updatedAt":"2026-05-18T19:07:27.255Z","lastSeenAt":"2026-05-18T19:07:27.255Z","tsv":"'/guides/operations/mcp-server#tools).':82 '1':220 '1889':335 '3.5':412,493,545 'across':440,464 'agent':46,67 'ai':66 'architectur':337 'array':287,457,560 'automat':196,266,356 'avail':13 'aw':208 'azur':211 'bge':405,486,538 'bge-reranker-v2-m3':404,485,537 'breakdown':172 'built':97,333 'built-in':96 'cascad':37,437 'cascading-search':36,436 'categori':336 'chunk':251,327,425 'cli':118 'cloud':140,206,214 'coher':410,491,543 'cohere-rerank':409,490,542 'configur':134,272 'contain':246,300 'count':167 'creat':26,93,179,183 'create-index-for-model':25,178 'current':127 'dedupl':445 'describ':19,22,131,156 'describe-index':18,130 'describe-index-stat':21,155 'detail':135 'dimens':142 'direct':318 'docs.pinecone.io':81 'docs.pinecone.io/guides/operations/mcp-server#tools).':80 'document':11,42,517,522,558,577 'e.g':216,250,424 'e5':232 'east':219 'eiffel':330 'emb':228,249,353 'embed':100,111,144,191,195,223,267 'embed.fieldmap.text':240 'embed.model':221 'english':238 'eq':393 'exampl':322 'expos':61 'extern':110,198 'field':146,244,298,303,313,420,501,581 'fieldmap':309 'filter':387 'final':507 'first':533 'follow':63 'gcp':209 'get':133,159 'gt':396 'gte':397 'guid':79 'handl':194 'id':295,297,325 'ide':69 'includ':164 'index':17,20,23,27,91,92,108,121,124,132,139,153,157,163,176,180,187,204,263,270,277,307,347,359,365,442,455,478 'insert':256 'instal':73 'instruct':74 'integr':90,190,262,346 'json':324 'key':83 'larg':233 'limit':84 'list':16,120,122,453 'list-index':15,119 'llama':226 'llama-text-embed-v2':225 'lt':398 'lte':399 'm3':408,489,541 'map':147 'mcp':3,8,52,54,59,77,87,352 'metadata':315,386 'metric':143 'model':29,101,112,145,182,192,199,224,273,361,403,484,535 'mongodb':390 'mongodb-styl':389 'multilingu':231 'multilingual-e5-large':230 'multipl':441 'must':292 'name':151,154,174,177,202,205,275,278,363,366,459 'namespac':171,279,281,367,369,460 'ne':394 'need':47,200 'nest':312 'new':185 'number':379,429,472,508,569 'object':461 'oper':392 'option':385,401,419,428,506,575 'options.rankfields':574 'options.topn':567 'paramet':150,173,201,274,362,454,534 'pass':348 'per':170,477 'per-namespac':169 'perform':529 'pinecon':2,7,51,53,58,86,99,117,128,193,236,415,496,548 'pinecone-mcp':1 'pinecone-rerank-v0':414,495,547 'pinecone-sparse-english-v0':235 'plain':349 'project':129 'put':316 'queri':355,376,469,527,551,554 'query.filter':384 'query.inputs.text':372,465 'query.topk':377,470 'rank':452 'rec1':326 'record':32,35,166,243,255,259,264,285,289,291,321,323,340,524,564,579 'refer':4,56 'region':141,212,215 'requir':152,175,203,207,213,222,241,276,280,286,364,368,373,378,456,466,471,482,500,536,552,559,568 'rerank':41,402,406,411,416,422,435,447,480,483,487,492,497,503,514,516,518,539,544,549,556,566,584 'rerank-docu':40,515 'rerank.model':400,481 'rerank.rankfields':418,499 'rerank.topn':427,505 'result':381,431,448,474,510,571 'retriev':476 'return':383,433,512,573 'search':34,38,339,343,371,438,439,463,532 'search-record':33,338 'see':75 'semant':341 'server':9,60,78 'serverless':186 'set':520 'setup':71 'simultan':443 'singl':451 'skill' 'skill-pinecone-mcp' 'source-pinecone-io' 'spars':237 'specif':138 'specifi':304 'standard':107 'stat':24,158 'statist':160 'status':149 'string':562 'style':391 'support':89 'text':227,247,252,302,328,342,350,375,426,468 'tool':10,14,55,64 'topic-agent-skills' 'topic-agents' 'topic-pinecone' 'topic-semantic-search' 'topic-skills-sh' 'total':165 'tower':331 'understand':49 'updat':258 'upsert':31,254,283 'upsert-record':30,253 'us':218 'us-east':217 'use':43,109,115,268,357,388 'v0':239,417,498,550 'v2':229,407,488,540 'vector':531 'without':528 'work':105","prices":[{"id":"90baaa78-8a60-4c95-a9c7-2462791cc9b2","listingId":"def999a5-4d75-4937-9e64-04ee9742773e","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.255Z"}],"sources":[{"listingId":"def999a5-4d75-4937-9e64-04ee9742773e","source":"github","sourceId":"pinecone-io/skills/pinecone-mcp","sourceUrl":"https://github.com/pinecone-io/skills/tree/main/skills/pinecone-mcp","isPrimary":false,"firstSeenAt":"2026-05-18T19:07:27.255Z","lastSeenAt":"2026-05-18T19:07:27.255Z"}],"details":{"listingId":"def999a5-4d75-4937-9e64-04ee9742773e","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"pinecone-io","slug":"pinecone-mcp","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":"5fbd7ae85e154f2dcb4a4678f12a442652fe05ce","skill_md_path":"skills/pinecone-mcp/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/pinecone-io/skills/tree/main/skills/pinecone-mcp"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"pinecone-mcp","description":"Reference for the Pinecone MCP server tools. Documents all available tools - list-indexes, describe-index, describe-index-stats, create-index-for-model, upsert-records, search-records, cascading-search, and rerank-documents. Use when an agent needs to understand what Pinecone MCP tools are available, how to use them, or what parameters they accept."},"skills_sh_url":"https://skills.sh/pinecone-io/skills/pinecone-mcp"},"updatedAt":"2026-05-18T19:07:27.255Z"}}