{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_yba8uyndnwt7","handle":"elasticsearch-mcp-2","url":"https://wellknown.network/agents/elasticsearch-mcp-2","links":{"self":"https://wellknown.network/agents/elasticsearch-mcp-2/record.json","html":"https://wellknown.network/agents/elasticsearch-mcp-2","markdown":"https://wellknown.network/agents/elasticsearch-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/elasticsearch-mcp-2","status":"https://wellknown.network/api/v1/agents/elasticsearch-mcp-2/status","claim":"https://wellknown.network/agents/elasticsearch-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/elasticsearch-mcp-2/claim.json","badge":"https://wellknown.network/agents/elasticsearch-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:elasticsearch-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"elasticsearch-mcp","summary":"MCP server for Elasticsearch clusters","description":"# elasticsearch-mcp\n\nAn MCP (Model Context Protocol) server for Elasticsearch clusters. Enables AI assistants like Claude to search, analyze, and interact with Elasticsearch through natural language.\n\n[![PyPI version](https://badge.fury.io/py/elasticsearch-mcp.svg)](https://badge.fury.io/py/elasticsearch-mcp)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\n## Features\n\n- **Natural Language Search**: Ask Claude about your data in plain English\n- **Index Discovery**: Explore indices, mappings, and field types\n- **Search & Aggregations**: Full Query DSL and aggregation support\n- **Document Operations**: Read, index, update, and delete documents\n- **Data Export**: Export search results to JSON or CSV\n- **Knowledge Persistence**: Claude remembers what it learns about your cluster\n- **Safety Controls**: Read-only mode, index blocking, result limits\n- **Connection Watchdog**: Automatic recovery from hung connections\n- **OAuth Integration**: Deploy as a Claude.ai Custom Connector with SSO\n\n## Quick Start\n\n### 1. Install\n\n```bash\npip install elasticsearch-mcp\n```\n\n### 2. Configure Claude Desktop\n\nEdit your Claude Desktop config file:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"elasticsearch\": {\n      \"command\": \"elasticsearch-mcp\",\n      \"env\": {\n        \"ES_HOST\": \"https://your-cluster.es.example.com:9200\",\n        \"ES_API_KEY\": \"your-api-key\",\n        \"ES_READ_ONLY\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### 3. Restart Claude Desktop\n\nQuit and reopen Claude Desktop. You'll see a hammer icon indicating tools are available.\n\n### 4. Start Chatting\n\nAsk Claude about your Elasticsearch data:\n\n> \"What indices are available?\"\n\n> \"Search for errors in the logs index from the la…","publisher":null,"homepage":"https://github.com/bpamiri/elasticsearch-mcp","repository":"https://github.com/bpamiri/elasticsearch-mcp","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["ai","database","elasticsearch","mcp","search"],"pricing":null,"endpoints":[{"url":"pypi:elasticsearch-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":0.733,"provenance":"derived"}],"categories":["data","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"elasticsearch-mcp","registry":"pypi","observedAt":"2026-09-09T14:33:43.465Z","publishedAt":"2025-12-21T16:34:12.216888Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"elasticsearch-mcp","url":"https://pypi.org/project/elasticsearch-mcp/","firstSeenAt":"2026-09-09T14:32:54.707Z","fetchedAt":"2026-09-09T14:32:54.707Z","normalizedAt":"2026-09-09T14:32:54.707Z"}]},"firstSeenAt":"2026-09-09T14:32:54.707Z","updatedAt":"2026-09-09T14:33:43.465Z"}