{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_sb69az8mkh5e","handle":"strawgate-es-mcp","url":"https://wellknown.network/agents/strawgate-es-mcp","links":{"self":"https://wellknown.network/agents/strawgate-es-mcp/record.json","html":"https://wellknown.network/agents/strawgate-es-mcp","markdown":"https://wellknown.network/agents/strawgate-es-mcp/record.md","api":"https://wellknown.network/api/v1/agents/strawgate-es-mcp","status":"https://wellknown.network/api/v1/agents/strawgate-es-mcp/status","claim":"https://wellknown.network/agents/strawgate-es-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/strawgate-es-mcp/claim.json","badge":"https://wellknown.network/agents/strawgate-es-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/strawgate-es-mcp/history","tools":"https://wellknown.network/api/v1/agents/strawgate-es-mcp/tools"},"ard":{"identifier":"urn:air::server:strawgate-es-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"strawgate_es_mcp","summary":"Strawgate's Elasticsearch MCP project","description":"# strawgate_es_mcp\n\nStrawgate's Unofficial MCP Server for Elasticsearch.\n\nUse at your own risk. This is not an official Elasticsearch product. This MCP Server will probably break your Elasticsearch cluster. Do not use it.\n\nThis project provides a Model Context Protocol (MCP) server implemented in Python using `fastmcp`. Its primary purpose is to expose a wide range of Elasticsearch client functionalities as callable MCP tools, allowing for interaction with an Elasticsearch cluster via the MCP.\n\n## Features\n\n- **Elasticsearch Tooling**: Exposes numerous Elasticsearch client APIs as MCP tools, including:\n    - CAT APIs (allocation, aliases, count, indices, nodes, shards, etc.)\n    - Cluster APIs (health, state, stats)\n    - Nodes APIs (info, stats)\n    - Indices APIs (create/get data stream, stats, resolve index)\n    - ILM and SLM APIs (get/explain lifecycle, get status, get stats)\n    - Shutdown APIs (get node)\n    - Search API\n- **CLI**: A CLI for the MCP Server.\n- **Extensible**: Easily add new Elasticsearch client methods as MCP tools or integrate with other MCP tools.\n- **Sample Script**: Includes `sample_multisearch.py` to demonstrate using the Elasticsearch Python client for multi-searches.\n- **Testing**: Includes unit tests for the exposed tools and sample scripts using `pytest`.\n\n## Setup in Windsurf\n\nOn the right in the cascade window press the hammer icon and add a server with the following configuration:\n\n```json\n{\n    \"mcpServers\": {\n        \"es-mcp\": {\n            \"command\": \"uvx\",\n            \"args\": [\n                \"--from\",\n                \"git+https://github.com/strawgate/py-mcp-collection.git#subdirectory=es-mcp\",\n                \"es-mcp\"\n            ],\n            \"env\": {\n                \"ES_HOST\": \"https://my-cloud-cluster:443\",\n                \"ES_API_KEY\": \"MYCOOLAPIKEY\"\n            }\n        }\n    }\n}\n```\n\n## VS Code McpServer Usage\n\n1. Open the command palette (Ctrl+Shift+P or Cmd+Shift+P).\n2. Type \"Settings\" and select \"Preferences: Open …","publisher":null,"homepage":null,"repository":null,"version":"0.6.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:strawgate_es_mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"code.testing","name":"Testing","confidence":0.825,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["code","dev"],"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":"strawgate_es_mcp","registry":"pypi","observedAt":"2026-11-04T01:24:57.674Z","publishedAt":"2025-08-04T14:11:25.910771Z","latestVersion":"0.6.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"strawgate_es_mcp","url":"https://pypi.org/project/strawgate_es_mcp/","firstSeenAt":"2026-09-10T13:19:54.720Z","fetchedAt":"2026-11-04T01:24:02.062Z","normalizedAt":"2026-11-04T01:24:02.062Z"}]},"firstSeenAt":"2026-09-10T13:19:54.720Z","updatedAt":"2026-11-04T01:24:57.674Z"}