Connectors · AI
Pinecone MCP server for AI agents.
actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Pinecone and the rest of your systems. It gives your agent 52 Pinecone actions (27 reads, 17 writes and 8 that wait for a confirmation) and holds the Pinecone credential itself, so the agent never does. It paces Pinecone's limits and records every call.
100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.
claude mcp add --transport http actionlake https://connect.actionlake.com/mcpdo { action: "pinecone.indexes.list", intent: "check which Pinecone account is connected"}# List indexes · read · 1 upstream call- 52actionsin one signed file
- 27readlook, never change
- 17writecreate and update
- 8wait for a yesdestructive, confirmed first
Set up
Connect Pinecone in three steps.
- 01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp - 02
Connect Pinecone.
API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
api_keyPinecone API key: console (app.pinecone.io) > your project > API keys > Create API keyhostWhere your Pinecone lives: your host
account { op: "connections.requirements", service: "pinecone" } # free: exactly what to paste, and what is found for you - 03
Make the first call. Check before a write.
Ask in plain words; Claude picks the action. Before anything changes,
checkvalidates the call and prices it, for free.do { action: "pinecone.indexes.list" }# list indexes · read · 1 upstream callcheck { action: "pinecone.indexes.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent
Pinecone at a glance
- Sign-in
- API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.
- You provide
api_key- Setup fields
host- Limits we pace to
- 20 calls a second, per connection
- API covered
- Pinecone API 2025-10 (db_control, db_data, inference, assistant_control, assistant_data, assistant_evaluation), at your Pinecone instance's API base URL, which you enter when connecting
- Built from
- Pinecone's documentation, read 22 October 2026OpenAPI spec (GitHub)OpenAPI spec (GitHub)OpenAPI spec (GitHub)
- Service file
- Version 1.0.0, signed (Ed25519)
- Cached reads
- 27 of 27 reads, for up to 2 minutes; a write clears what it affects
- Shared entities
- 1, so ask can line Pinecone up with your other systems
- Data
- Processed and stored in Sydney, Australia. No US region yet
Capabilities
What an AI agent can do in Pinecone.
52 actions in 14 areas. Every one carries its effect, so a key can allow the reads and hold the rest.
- 27readlook, never change
- 17writecreate and update
- 8destructivewait for a confirmation
Assistants
83 read · 4 write · 1 destructive
Chat with an assistant · Chat through an OpenAI-compatible interface · Retrieve context from an assistant · Create an assistant
Vectors
74 read · 2 write · 1 destructive
Fetch vectors by metadata · List vector IDs · Search with a vector · Fetch vectors
Backups
63 read · 2 write · 1 destructive
Create a backup of an index · Create an index from a backup · List backups for all indexes in a project · List backups for an index
Indexes
62 read · 3 write · 1 destructive
List indexes · Create an index · Create an index with integrated embedding · Describe an index
Bulk imports
42 read · 1 write · 1 destructive
List imports · Start import · Describe an import · Cancel an import
Collections
42 read · 1 write · 1 destructive
Create a collection · List collections · Describe a collection · Delete a collection
Namespaces
42 read · 1 write · 1 destructive
Create a namespace · List namespaces · Describe a namespace · Delete a namespace
Assistant files
32 read · 0 write · 1 destructive
List Files · Describe a file upload · Delete an uploaded file
6 more areas · 10 actions
- Inference 2
- Models 2
- Records 2
- Restore jobs 2
- Evaluation 1
- Index stats 1
Top actions
The Pinecone API, shaped for agents.
The ids your agent types, what each does, and the one name it shares with other systems.
| Action | What it does | Effect | Same name in |
|---|---|---|---|
pinecone.indexes.listList indexes | List indexes. | read | this connector |
pinecone.vectors.listList vector IDs | List vector IDs. | read | this connector |
pinecone.vectors.querySearch with a vector | Search with a vector. | read | this connector |
pinecone.indexes.createCreate an index | Create an index. | write | this connector |
pinecone.records.searchSearch with text | Search with text. | read | this connector |
pinecone.assistants.chatChat with an assistant | Chat with an assistant. | write | this connector |
pinecone.assistants.listList assistants | List assistants. | read | this connector |
pinecone.inference.embedGenerate vectors | Generate vectors. | write | this connector |
pinecone.namespaces.listList namespaces | List namespaces. | read | this connector |
pinecone.inference.rerankRerank results | Rerank results. | read | this connector |
pinecone.namespaces.createCreate a namespace | Create a namespace. | write | this connector |
pinecone.indexes.deleteDelete an index | Delete an index. | destructive | this connector |
Try it
Prompts to paste into Claude.
Each one names the Pinecone actions it will call, so you know what it reads and what it changes before you send it.
- Readread
List indexes in Pinecone and tell me what stands out.
calls
pinecone.indexes.list - Writewrite
Create an index in Pinecone. Show me exactly what you will send before you save it.
calls
pinecone.indexes.create
Governance for Pinecone
Destructive actions wait for a yes.
8 Pinecone actions are destructive. These are all of them:
- Delete an index
pinecone.indexes.delete - Delete vectors
pinecone.vectors.delete - Delete an assistant
pinecone.assistants.delete - Delete a namespace
pinecone.namespaces.delete - Delete a backup
pinecone.backups.delete - Delete a collection
pinecone.collections.delete - Delete an uploaded file
pinecone.assistant_files.delete - Cancel an import
pinecone.bulk_imports.cancel
A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.
Delete an index?
intent: the user asked me to delete an index
account { op: "keys.create", name: "pinecone-agent", allowed_actions: ["pinecone.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "pinecone.indexes.delete", approver: "[email protected]" }, { match: "pinecone.vectors.delete", approver: "[email protected]" }, { match: "pinecone.assistants.delete", approver: "[email protected]" } ]}Cost
What Pinecone costs on actionlake.
Every Pinecone action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call Pinecone refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
- 1upstream call per actionall 52 Pinecone actions
- 6actions pageeach page of a long list is one call
- 27reads can be cacheda cache hit costs nothing
- 100,000calls a month, freepaid plans from US$49 a month for 250,000
Action index
Every Pinecone action.
52 actions by area: the id your agent calls, what it does, and its effect.
Assistants8
pinecone.assistants.chatChat with an assistantwritepinecone.assistants.chat_completionsChat through an OpenAI-compatible interfacewritepinecone.assistants.contextRetrieve context from an assistantreadpinecone.assistants.createCreate an assistantwritepinecone.assistants.deleteDelete an assistantdestructivepinecone.assistants.getCheck assistant statusreadpinecone.assistants.listList assistantsreadpinecone.assistants.updateUpdate an assistantwrite
Vectors7
pinecone.vectors.deleteDelete vectorsdestructivepinecone.vectors.fetchFetch vectorsreadpinecone.vectors.fetch_by_metadataFetch vectors by metadatareadpinecone.vectors.listList vector IDsreadpinecone.vectors.querySearch with a vectorreadpinecone.vectors.updateUpdate a vectorwritepinecone.vectors.upsertUpsert vectorswrite
Backups6
pinecone.backups.createCreate a backup of an indexwritepinecone.backups.create_indexCreate an index from a backupwritepinecone.backups.deleteDelete a backupdestructivepinecone.backups.getDescribe a backupreadpinecone.backups.listList backups for all indexes in a projectreadpinecone.backups.list_for_indexList backups for an indexread
Indexes6
pinecone.indexes.configureConfigure an indexwritepinecone.indexes.createCreate an indexwritepinecone.indexes.create_for_modelCreate an index with integrated embeddingwritepinecone.indexes.deleteDelete an indexdestructivepinecone.indexes.getDescribe an indexreadpinecone.indexes.listList indexesread
Bulk imports4
pinecone.bulk_imports.cancelCancel an importdestructivepinecone.bulk_imports.getDescribe an importreadpinecone.bulk_imports.listList importsreadpinecone.bulk_imports.startStart importwrite
Collections4
pinecone.collections.createCreate a collectionwritepinecone.collections.deleteDelete a collectiondestructivepinecone.collections.getDescribe a collectionreadpinecone.collections.listList collectionsread
Namespaces4
pinecone.namespaces.createCreate a namespacewritepinecone.namespaces.deleteDelete a namespacedestructivepinecone.namespaces.getDescribe a namespacereadpinecone.namespaces.listList namespacesread
Assistant files3
pinecone.assistant_files.deleteDelete an uploaded filedestructivepinecone.assistant_files.getDescribe a file uploadreadpinecone.assistant_files.listList Filesread
Inference2
pinecone.inference.embedGenerate vectorswritepinecone.inference.rerankRerank resultsread
Models2
pinecone.models.getDescribe a modelreadpinecone.models.listList available modelsread
Records2
pinecone.records.searchSearch with textreadpinecone.records.upsertUpsert textwrite
Restore jobs2
pinecone.restore_jobs.getDescribe a restore jobreadpinecone.restore_jobs.listList restore jobsread
Evaluation1
pinecone.evaluation.alignmentEvaluate an answerwrite
Index stats1
pinecone.index_stats.getGet index statsread
Questions
The Pinecone MCP server, answered.
Is there a Pinecone MCP server for Claude?
Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 52 Pinecone actions across assistants, vectors, backups and indexes, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Pinecone.
What do I need to connect Pinecone?
Pinecone API key: console (app.pinecone.io) > your project > API keys > Create API key. Plus your host. The free call account { op: "connections.requirements", service: "pinecone" } lists exactly what to paste.
Can an AI agent delete or change things in Pinecone?
Only if its key allows it, and only with an explicit confirmation. 8 Pinecone actions are destructive, including delete an index, delete vectors and delete an assistant. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.
Will an AI agent use up my Pinecone API limit?
actionlake paces every call to the limits in the Pinecone service file: 20 calls a second per connection. Repeated reads are answered from cache (27 Pinecone actions can be), which never reaches Pinecone.
What does a Pinecone action cost?
One upstream call, the only unit actionlake bills. A list that pages bills one call per page (6 Pinecone actions page). Cache hits, searches, dry runs and calls Pinecone refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
Which Pinecone API does it cover?
The Pinecone API 2025-10 (db_control, db_data, inference, assistant_control, assistant_data, assistant_evaluation) at your Pinecone instance's API base URL, which you enter when connecting. It is built from Pinecone's documentation as read on 22 October 2026. 52 actions in 14 areas, each one in the signed service file (version 1.0.0).
Does actionlake keep my Pinecone data, and where?
actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 2 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Pinecone credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.
Which AI clients can use it?
Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.
Give your agent Pinecone today.
Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.