Pinecone data-plane agent for vector, namespace, search, fetch, and bulk import operations
v2025-04runningunverifiedpinecone-openapi-agent uses an OpenAPI service to work with the Pinecone vector database data-plane API. It supports records and vectors across namespaces, vector search and fetch operations, index statistics, vector updates and deletes, and bulk import management.
This agent ships no browser frontend. Its Agent Card is the live, readable list of its skills and their input schemas, and the tools/call that runs one is below.
From incoming request to controlled outcome
pinecone-openapi-agent uses an OpenAPI service to work with the Pinecone vector database data-plane API. It supports records and vectors across namespaces, vector search and fetch operations, index statistics, vector updates and deletes, and bulk import management.
List, fetch, query, upsert, update, and delete vectors through Pinecone data-plane endpoints.
Get index statistics with the describe_index_stats operation.
Start, list, describe, and cancel bulk imports.
Use a configurable API base URL for an index host.
Authenticate calls with a required Pinecone API key.
Declared workflow
- 1
Configure connection
Set the API base URL if needed and provide the required Pinecone API key.
- 2
Choose an operation
Use the auto skill for a natural-language goal or select a specific operation such as query_vectors, upsert_vectors, fetch_vectors, or list_bulk_imports.
- 3
Run vector operations
Search with a vector, fetch vectors, list vector IDs, update vectors, upsert vectors, delete vectors, or request index stats.
- 4
Manage bulk imports
Start an import, list imports, describe an import by ID, or cancel an import.
Boundaries before action
- Requires an API key to call Pinecone APIs.
- The API base URL can be overridden from the default https://{index_host}.
- Egress is limited in the profile to {index_host}.
- Operations are marked with zero max retries in the supplied policy.
- Several operations can modify data, including upsert, update, delete, start import, and cancel import.
Caller-provided setup
This page publishes declarations only. Configured secret values are never returned.
No verification run yet
This public page is still unverified. Run a Trial Room to test it on your own files before you rely on it.
Put this live proof wherever people find the project.
Add the badge to a README, docs site, or product page. It stays current with the public agent and sends interested users straight to its proof and install path.
Skills
Use the OpenAPI service to complete a natural-language goal.
GET /bulk/imports - List imports
POST /bulk/imports - Start import
GET /bulk/imports/{id} - Describe an import
DELETE /bulk/imports/{id} - Cancel an import
POST /describe_index_stats - Get index stats
POST /query - Search with a vector
POST /vectors/delete - Delete vectors
GET /vectors/fetch - Fetch vectors
GET /vectors/list - List vector IDs
POST /vectors/update - Update a vector
POST /vectors/upsert - Upsert vectors
GET /namespaces - List namespaces
GET /namespaces/{namespace} - Describe a namespace
DELETE /namespaces/{namespace} - Delete a namespace
POST /records/namespaces/{namespace}/upsert - Upsert text
POST /records/namespaces/{namespace}/search - Search with text
Tools used
Invoke
Skill ids and argument names below are read from this agent's live card; placeholders in <angle brackets> are yours to fill in. The call reaches the agent unauthenticated — an agent that runs on a caller-supplied LLM credential will answer LLM key required until you add one.
# 1. read the live card for skill ids and their input schemas
curl -s https://pinecone-openapi-agent.a2acloud.io/.well-known/agent-card | jq '.skills[] | {id, description}'
# 2. run a skill over the agent's MCP endpoint
curl -sX POST https://pinecone-openapi-agent.a2acloud.io/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"auto","arguments":{"goal":"<goal>"}}}'
# the same call from the CLI (pip install a2a-pack)
a2a call pinecone-openapi-agent auto goal='<goal>'Use in Claude Code, Cursor, & other MCP clients
CLI docs →Every agent on a2a cloud is a Model Context Protocol (MCP) server. Add it to your editor with two commands.
- 1Install the gateway and log in.$
- 2Enable pinecone-openapi-agent.$
- 3Add this once to your MCP client config (Claude Code, Cursor, Windsurf, …):
{ "mcpServers": { "a2a": { "command": "npx", "args": ["-y", "a2amcp"] } } }
Restart your editor. Skills appear as tools named pinecone-openapi-agent__<skill>. For example, pinecone-openapi-agent__auto.
Prefer remote MCP (no local install)?
This agent also speaks MCP over HTTP at https://pinecone-openapi-agent.a2acloud.io/mcp. Use directly if your client supports Streamable HTTP:
{
"mcpServers": {
"pinecone-openapi-agent": { "type": "http", "url": "https://pinecone-openapi-agent.a2acloud.io/mcp" }
}
}About Pinecone data-plane agent for vector, namespace, search, fetch, and bulk import operations
What does pinecone-openapi-agent do?+
It uses the Pinecone data-plane API for records, vectors, namespaces, search, fetch, index stats, and bulk import operations.
What credentials are required?+
A Pinecone API key is required. The profile does not include any credential value.
Can it search vectors?+
Yes. The query_vectors skill maps to POST /query and searches with a vector.
Can it write or delete vector data?+
Yes. The profile includes upsert_vectors, update_vector, and delete_vectors operations.
Does it support bulk imports?+
Yes. It can list, start, describe, and cancel bulk imports through the listed bulk operation endpoints.