@elastic.io/mcp 1.0.0 → 1.0.1-beta

package/README.md

@@ -1,171 +1,173 @@
 # elastic.io Model Context Protocol (MCP) Server
 
-A professional, production-ready TypeScript-based Model Context Protocol (MCP) server that connects Large Language Models (LLMs) to the **elastic.io** iPaaS platform REST API v2.
+An MCP server that connects AI assistants to the **elastic.io** iPaaS platform — letting them discover, build, modify, and debug integration flows directly.
 
-This server enables AI assistants (such as Antigravity, Claude Desktop, Cursor, or custom frontends) to discover, construct, modify, manage, and debug integration flows directly.
+Full documentation: [GitHub](https://github.com/elasticio/mcp)
 
----
+## Terms of Use
 
-## What is the MCP Server?
+The elastic.io MCP server is optional. By connecting an AI agent to elastic.io through it, you agree to the [elastic.io Terms of Use](https://www.elastic.io/terms-of-use/), in particular section 9 (*MCP Interface and AI agents*).
 
-This server implements the **Model Context Protocol (MCP)**, a standard protocol that lets LLMs securely query and mutate data in external systems. 
+In short:
 
-Specifically, this server acts as an intelligent intermediary between an LLM agent and the elastic.io integration platform, exposing 32 distinct tools that translate high-level requests into raw API operations. It allows LLMs to list components, discover credentials, create and manage flows, build mappings with JSONata expressions, analyze run-time logs, and etc.
+- **Your agent acts as you.** Everything your AI agent does through MCP counts as an action of your elastic.io account.
+- **Limit its permissions.** The agent can read, change and delete data within the permissions of the user account you connect. Use a dedicated user with only the permissions the agent needs, and read-only access wherever possible.
+- **Your data goes to your AI provider.** Data the agent reads is sent to the AI provider you use. You are responsible for your agreement with that provider.
+- **We don't control your agent.** elastic.io does not provide or control your AI agent and is not responsible for its actions or outputs.
+- **We don't use AI on your data.** elastic.io does not use AI to process your data and does not use it to train AI models.
 
 ---
 
-## How It Works
+## Quick Start
+
+### Prerequisites
+
+1. **Node.js 22+** — download from [nodejs.org](https://nodejs.org/)
+2. **A desktop AI client** — install one of the supported clients (see below)
+3. **elastic.io credentials** — log in to your elastic.io account, go to your profile page, and copy the `curl` command shown there (it looks like `curl https://api.elastic.io/v2/users/me -u your_email:your_api_key`). The setup wizard accepts this command directly — just paste it when prompted.
 
-The server can run in two modes, depending on the transport protocol selected:
+### One-Command Setup
 
+Run this in your terminal — it will detect your installed AI clients and configure them automatically:
+
+**macOS / Linux:**
+```
+npx -y @elastic.io/mcp setup
 ```
-[Stdio Mode (Local)]
-LLM Client (Cursor) <--> [stdin / stdout] <--> MCP Server (uses static env keys)
 
-[SSE Mode (Cloud)]
-LLM Client (Browser/IDE) <--> [HTTP / SSE] <--> Express Server <--> Session Manager <--> Scoped MCP Server & Client (uses dynamic user keys)
+**Windows (PowerShell):**
+```powershell
+npx -y "@elastic.io/mcp" setup
 ```
 
-### 1. Stdio Mode (Standard Input/Output)
-* **Design:** Designed for a single developer working locally on an IDE (Cursor, Claude Desktop).
-* **Process:** The LLM client starts the node server as a subprocess. Communication occurs over standard streams. The server loads static authentication credentials (`ELASTICIO_API_EMAIL` and `ELASTICIO_API_KEY`) from environment variables (or a local `.env` file).
+> **Windows notes:**
+> - Always wrap the package name in quotes (`"@elastic.io/mcp"`) — PowerShell misinterprets the `@` symbol without them.
+> - If you get a `PSSecurityException` error, allow script execution for your user first:
+>   ```powershell
+>   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
+>   ```
 
-### 2. SSE Mode (Server-Sent Events)
-* **Design:** Designed to be hosted centrally in the cloud as a multi-tenant service.
-* **Process:** The server runs an Express HTTP server.
-  * **Session Initialization:** The client connects to `GET /sse` passing an `Authorization` header containing their personal elastic.io email/API Key (Basic Auth).
-  * **Session Isolation:** The `SessionManager` captures this connection, generates a unique session ID, and spins up a dedicated `McpServer` and a request-scoped `Axios` instance. This guarantees that user credentials and API states are completely isolated.
-  * **Tool Calls:** The client POSTs JSON-RPC tool calls to `POST /messages` or `POST /sse`, supplying the `mcp-session-id` header to route the message to their isolated session.
+Works on macOS, Linux, and Windows. The setup wizard will:
+1. Check your Node.js version (22+ required)
+2. Accept the `curl` command from your profile page (or ask for email and API key manually)
+3. Detect which AI clients are installed on your machine
+4. Resolve the full path to `node`/`npx` (handles NVM, fnm, Homebrew, etc.)
+5. Write the MCP config files with correct paths for each client
 
-### Core Safeguards & Optimizations
-* **State-Machine Verification:** To prevent the LLM from configuring flows using cached or hallucinated IDs, the validation engine enforces that components and credentials must be fetched/discovered in the current session before they can be configured in a graph.
-* **JSONata Safety Checks:** The server reviews generated mappings, warning the LLM if it wraps JSONata mappers in outer quotes (making them strings) or references variables directly instead of using `$getPassthrough().step_id.body.field`.
-* **Token Optimization:** Component details are retrieved in two steps to prevent token bloat. Large metadata objects and enums are dynamically pruned when they exceed limits.
+After setup, **restart your AI client** — the elastic.io tools will appear in the chat.
 
----
+### Supported Clients
+
+Claude Desktop, Claude Code, ChatGPT / Codex, Cursor, VS Code (Copilot), Windsurf, Gemini CLI / Gemini IDE, Zed, Cline, Trae, Qwen Code, Kimi Code, DeepSeek.
+
+See the [full client table with config paths](https://github.com/elasticio/mcp#supported-clients) on GitHub.
+
+### Manual Configuration
+
+If you prefer to configure manually, add the following to your client's MCP config file:
 
-## Execution Process & Requirements
-
-### Requirements
-* **Node.js** (version 18 or higher)
-* **npm** or yarn
-* **Embedding Provider API Key** (required for creating documentation and flow sample embeddings, e.g. Gemini).
-* **Vector Store URL and API Key** (for semantic search capabilities, e.g. Qdrant).
-
-### Local Setup
-1. Clone this repository and install dependencies:
-   ```bash
-   npm install
-   ```
-2. Copy `.env.example` to `.env` and fill out your variables:
-   ```bash
-   cp .env.example .env
-   ```
-3. Build the project:
-   ```bash
-   npm run build
-   ```
-
-### Running Locally (Stdio Mode)
-To run the server locally inside your IDE (e.g. Cursor or Claude Desktop):
-```bash
-node dist/index.js
-```
-Configure your client configuration file (e.g., `mcp_config.json`) to invoke this command, providing the required environment variables:
 ```json
 {
   "mcpServers": {
-    "elasticio-mcp": {
-      "command": "node",
-      "args": ["/path/to/project/dist/index.js"],
-      "cwd": "/path/to/project",
+    "elasticio": {
+      "command": "npx",
+      "args": ["-y", "@elastic.io/mcp"],
       "env": {
         "ELASTICIO_API_EMAIL": "your_email@example.com",
         "ELASTICIO_API_KEY": "your_api_key",
-        "EMBEDDING_PROVIDER_API_KEY": "your_embedding_provider_api_key",
-        "VECTOR_STORE_URL": "your_vector_store_url",
-        "VECTOR_STORE_API_KEY": "your_vector_store_api_key"
+        "ELASTICIO_API_BASE_URL": "https://api.elastic.io/v2"
       }
     }
   }
 }
 ```
 
-### Running in Cloud Mode (SSE Mode)
-To start the server in Server-Sent Events mode:
+> **Note:** ChatGPT / Codex uses TOML format — use `npx -y @elastic.io/mcp setup` for automatic configuration.
+
+---
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `ELASTICIO_API_EMAIL` | yes | — | Your elastic.io account email |
+| `ELASTICIO_API_KEY` | yes | — | Your elastic.io API key |
+| `ELASTICIO_API_BASE_URL` | no | `https://api.elastic.io/v2` | Base URL for the elastic.io REST API |
+
+---
+
+## Update
+
+To update to the latest version, clear the npx cache first, then run setup again:
+
 ```bash
-npm run start:sse
-```
-* The server will run on the port defined by the `PORT` environment variable (defaults to `3000`).
-* Connect via the SSE endpoint `http://localhost:3000/sse` (or your cloud hosting URL) supplying your elastic.io credentials via basic auth.
+# macOS / Linux
+npx -y clear-npx-cache && npx -y @elastic.io/mcp setup
 
-#### Client Configuration (e.g., Cursor, Custom UI, or Antigravity)
-To connect your local client to a hosted cloud instance, configure it to run over the HTTP/SSE transport instead of command lines:
-```json
-{
-  "mcpServers": {
-    "elasticio-mcp-cloud": {
-      "url": "https://your-mcp-server.yourdomain.com/sse",
-      "headers": {
-        "x-elasticio-email": "your_email@example.com",
-        "x-elasticio-api-key": "your_api_key"
-      }
-    }
-  }
-}
+# Windows (PowerShell)
+npx -y clear-npx-cache; npx -y "@elastic.io/mcp" setup
 ```
-*Note: Alternatively, you can use the standard HTTP Basic Authentication header: `"Authorization": "Basic <base64_encoded_email_and_api_key>"`. Using `x-elasticio-email` and `x-elasticio-api-key` is recommended to avoid manually calculating base64 values.*
+
+This ensures npx fetches the latest version from npm. Your credentials will be re-prompted. Restart your AI clients after the update.
 
 ---
 
-## Embedding & Ingestion Process
-
-The server uses semantic search to locate documentation and similar flow configuration examples for the LLM. You must populate the vector database using one of two methods:
-
-### 1. Ingesting Local Files
-The project includes command-line scripts to parse, embed, and index local resources:
-* **Ingest Documentation:** Parses the markdown files located in `resources/elasticio.github.io/content/` and uploads them to the Qdrant `documentation` collection:
-  ```bash
-  node dist/scripts/ingest_docs.js
-  ```
-* **Ingest Flow Templates:** Parses the local JSON templates located in `resources/flow-examples/` and uploads them to the Qdrant `flow_samples` collection:
-  ```bash
-  node dist/scripts/ingest_flow_examples.js
-  ```
-* **Verify Search:** Runs test search queries against Qdrant to confirm embeddings were correctly indexed:
-  ```bash
-  node dist/scripts/test_search.js --query "your query string" --collection "flow_samples"
-  ```
-
-### 2. Live Webhook Ingestion (SSE Mode)
-When running in cloud/SSE mode, the server exposes an endpoint to ingest real-time flows directly from platform databases or sync scripts:
-* **Endpoint:** `POST /api/samples` (accepts a JSON array of processed flows).
-* **Execution Workflow:**
-  1. The server accepts the payload immediately with a `202 Accepted` response to prevent blocking network execution, then queues the tasks.
-  2. The background queue processing cleans and formats the flow structure, step settings, and JSONata mapper edges into a markdown document.
-  3. The structured text chunks are batched (up to 100 items per batch) and sent to the embedding API provider.
-  4. A 5-second delay is introduced between batches to respect API provider rate limits.
-  5. The resulting vectors are saved under the `flow_samples` collection in the vector database.
+## Uninstall
 
----
+To completely remove the elastic.io MCP server and its credentials from your machine:
+
+### 1. Remove the `elasticio` entry from your AI client configs
+
+Open the config file for each client you configured and delete the `elasticio` section. Config file locations:
+
+| Client | macOS | Windows | Linux |
+|---|---|---|---|
+| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` | `%APPDATA%\Claude\claude_desktop_config.json` | `~/.config/Claude/claude_desktop_config.json` |
+| Claude Code | `~/.claude.json` | `~/.claude.json` | `~/.claude.json` |
+| ChatGPT / Codex | `~/.codex/config.toml` | `~/.codex/config.toml` | `~/.codex/config.toml` |
+| Cursor | `~/.cursor/mcp.json` | `~/.cursor/mcp.json` | `~/.cursor/mcp.json` |
+| VS Code (Copilot) | `~/Library/Application Support/Code/User/mcp.json` | `%APPDATA%\Code\User\mcp.json` | `~/.config/Code/User/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `~/.codeium/windsurf/mcp_config.json` | `~/.codeium/windsurf/mcp_config.json` |
+| Gemini CLI / Gemini IDE | `~/.gemini/config/mcp_config.json` | `~/.gemini/config/mcp_config.json` | `~/.gemini/config/mcp_config.json` |
+| Zed | `~/.config/zed/settings.json` | `~/.config/zed/settings.json` | `~/.config/zed/settings.json` |
+| Cline (VS Code) | `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` | `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json` | `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
+| Trae | `~/.trae/mcp.json` | `~/.trae/mcp.json` | `~/.trae/mcp.json` |
+| Qwen Code | `~/.qwen/settings.json` | `~/.qwen/settings.json` | `~/.qwen/settings.json` |
+| Kimi Code | `~/.kimi-code/mcp.json` | `~/.kimi-code/mcp.json` | `~/.kimi-code/mcp.json` |
+| DeepSeek | `~/.deepseek/mcp.json` | `~/.deepseek/mcp.json` | `~/.deepseek/mcp.json` |
 
-## Limitations
+### 2. Clear the npx cache
 
-If you deploy this MCP server to a cloud infrastructure, be aware of the following implementation limitations:
+The MCP server binary is cached by npx. To remove it:
 
-1. **In-Memory Rate Limiter:**
-   The connection rate limiter in `src/index.ts` records IP requests in an in-memory JavaScript `Map`. This has two drawbacks:
-   * **Stale IP Leak:** Connected IP keys are never removed from the map. In long-running public environments, this will cause a slow memory leak.
-   * **Clustering:** It cannot share rate limit state across multiple instances/containers running behind a load balancer. For production, replace it with `express-rate-limit` using a Redis store.
+```bash
+# macOS / Linux
+npx -y clear-npx-cache
+# or manually:
+rm -rf ~/.npm/_npx
+
+# Windows (PowerShell)
+Remove-Item -Recurse -Force "$env:USERPROFILE\.npm\_npx"
+```
+
+### 3. Revoke your API key
+
+Your elastic.io API key is stored in plain text in each config file listed above. After removing the config entries:
+
+1. Log in to your elastic.io account
+2. Go to your profile page
+3. Regenerate your API key
 
-2. **Local Logging writes:**
-   The logger (`src/api/logger.ts`) is configured to append logs locally to a file named `mcp-server.log` on the filesystem, in addition to writing to `stderr`. 
-   * **Ephemereal Storage:** Writing logs to local disk will eventually fill up ephemeral disk storage in container environments like AWS ECS or GCP Cloud Run.
-   * **Recommendation:** Disable local file writes in production, relying solely on standard output/error streaming.
+This invalidates the old key even if a copy remains on disk.
+
+> **Security note:** Keep your MCP credentials secret and revoke them without delay if you suspect they may have been compromised.
+
+### 4. Restart your AI clients
+
+Restart any AI clients that were configured to pick up the changes.
+
+---
 
-3. **In-Memory Session Management (Boilerplate Code):**
-   The custom `SessionManager` manages stateful, multi-tenant mappings between SSE connection scopes and in-memory class instances. If the server process restarts, all active sessions are lost, causing `404` errors for connected clients until they re-establish connections.
-   * **Recommendation (Shifting to Mature Solutions):** For enterprise deployment, you should consider transitioning from in-memory session multiplexing to one of two mature architectural patterns:
-     * **3rd-Party Gateway/Proxy**: Run the MCP server in standard local `stdio` mode and wrap it using an off-the-shelf gateway (such as ContextForge Gateway, Apache APISIX with `mcp-bridge` plugin, or Supergateway). These gateways manage routing, SSL, authentication, and SSE session tracking out-of-the-box.
-     * **Infrastructure Isolation**: Deploy the server purely in `stdio` mode inside isolated, single-tenant container tasks (e.g. AWS ECS, GCP Cloud Run, or Fly.io micro-VMs) scheduled on-demand by a cloud orchestrator. This provides strict process-level security isolation and delegates lifecycles to your cloud provider, eliminating the need to write custom reapers or session hydration logic.
+## Licence
 
+This package is open-source under the [Apache 2.0](./LICENSE) licence. Connecting it to the elastic.io platform is subject to the Terms of Use above.

package/README.npm.md

@@ -0,0 +1,173 @@
+# elastic.io Model Context Protocol (MCP) Server
+
+An MCP server that connects AI assistants to the **elastic.io** iPaaS platform — letting them discover, build, modify, and debug integration flows directly.
+
+Full documentation: [GitHub](https://github.com/elasticio/mcp)
+
+## Terms of Use
+
+The elastic.io MCP server is optional. By connecting an AI agent to elastic.io through it, you agree to the [elastic.io Terms of Use](https://www.elastic.io/terms-of-use/), in particular section 9 (*MCP Interface and AI agents*).
+
+In short:
+
+- **Your agent acts as you.** Everything your AI agent does through MCP counts as an action of your elastic.io account.
+- **Limit its permissions.** The agent can read, change and delete data within the permissions of the user account you connect. Use a dedicated user with only the permissions the agent needs, and read-only access wherever possible.
+- **Your data goes to your AI provider.** Data the agent reads is sent to the AI provider you use. You are responsible for your agreement with that provider.
+- **We don't control your agent.** elastic.io does not provide or control your AI agent and is not responsible for its actions or outputs.
+- **We don't use AI on your data.** elastic.io does not use AI to process your data and does not use it to train AI models.
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+1. **Node.js 22+** — download from [nodejs.org](https://nodejs.org/)
+2. **A desktop AI client** — install one of the supported clients (see below)
+3. **elastic.io credentials** — log in to your elastic.io account, go to your profile page, and copy the `curl` command shown there (it looks like `curl https://api.elastic.io/v2/users/me -u your_email:your_api_key`). The setup wizard accepts this command directly — just paste it when prompted.
+
+### One-Command Setup
+
+Run this in your terminal — it will detect your installed AI clients and configure them automatically:
+
+**macOS / Linux:**
+```
+npx -y @elastic.io/mcp setup
+```
+
+**Windows (PowerShell):**
+```powershell
+npx -y "@elastic.io/mcp" setup
+```
+
+> **Windows notes:**
+> - Always wrap the package name in quotes (`"@elastic.io/mcp"`) — PowerShell misinterprets the `@` symbol without them.
+> - If you get a `PSSecurityException` error, allow script execution for your user first:
+>   ```powershell
+>   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
+>   ```
+
+Works on macOS, Linux, and Windows. The setup wizard will:
+1. Check your Node.js version (22+ required)
+2. Accept the `curl` command from your profile page (or ask for email and API key manually)
+3. Detect which AI clients are installed on your machine
+4. Resolve the full path to `node`/`npx` (handles NVM, fnm, Homebrew, etc.)
+5. Write the MCP config files with correct paths for each client
+
+After setup, **restart your AI client** — the elastic.io tools will appear in the chat.
+
+### Supported Clients
+
+Claude Desktop, Claude Code, ChatGPT / Codex, Cursor, VS Code (Copilot), Windsurf, Gemini CLI / Gemini IDE, Zed, Cline, Trae, Qwen Code, Kimi Code, DeepSeek.
+
+See the [full client table with config paths](https://github.com/elasticio/mcp#supported-clients) on GitHub.
+
+### Manual Configuration
+
+If you prefer to configure manually, add the following to your client's MCP config file:
+
+```json
+{
+  "mcpServers": {
+    "elasticio": {
+      "command": "npx",
+      "args": ["-y", "@elastic.io/mcp"],
+      "env": {
+        "ELASTICIO_API_EMAIL": "your_email@example.com",
+        "ELASTICIO_API_KEY": "your_api_key",
+        "ELASTICIO_API_BASE_URL": "https://api.elastic.io/v2"
+      }
+    }
+  }
+}
+```
+
+> **Note:** ChatGPT / Codex uses TOML format — use `npx -y @elastic.io/mcp setup` for automatic configuration.
+
+---
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `ELASTICIO_API_EMAIL` | yes | — | Your elastic.io account email |
+| `ELASTICIO_API_KEY` | yes | — | Your elastic.io API key |
+| `ELASTICIO_API_BASE_URL` | no | `https://api.elastic.io/v2` | Base URL for the elastic.io REST API |
+
+---
+
+## Update
+
+To update to the latest version, clear the npx cache first, then run setup again:
+
+```bash
+# macOS / Linux
+npx -y clear-npx-cache && npx -y @elastic.io/mcp setup
+
+# Windows (PowerShell)
+npx -y clear-npx-cache; npx -y "@elastic.io/mcp" setup
+```
+
+This ensures npx fetches the latest version from npm. Your credentials will be re-prompted. Restart your AI clients after the update.
+
+---
+
+## Uninstall
+
+To completely remove the elastic.io MCP server and its credentials from your machine:
+
+### 1. Remove the `elasticio` entry from your AI client configs
+
+Open the config file for each client you configured and delete the `elasticio` section. Config file locations:
+
+| Client | macOS | Windows | Linux |
+|---|---|---|---|
+| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` | `%APPDATA%\Claude\claude_desktop_config.json` | `~/.config/Claude/claude_desktop_config.json` |
+| Claude Code | `~/.claude.json` | `~/.claude.json` | `~/.claude.json` |
+| ChatGPT / Codex | `~/.codex/config.toml` | `~/.codex/config.toml` | `~/.codex/config.toml` |
+| Cursor | `~/.cursor/mcp.json` | `~/.cursor/mcp.json` | `~/.cursor/mcp.json` |
+| VS Code (Copilot) | `~/Library/Application Support/Code/User/mcp.json` | `%APPDATA%\Code\User\mcp.json` | `~/.config/Code/User/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `~/.codeium/windsurf/mcp_config.json` | `~/.codeium/windsurf/mcp_config.json` |
+| Gemini CLI / Gemini IDE | `~/.gemini/config/mcp_config.json` | `~/.gemini/config/mcp_config.json` | `~/.gemini/config/mcp_config.json` |
+| Zed | `~/.config/zed/settings.json` | `~/.config/zed/settings.json` | `~/.config/zed/settings.json` |
+| Cline (VS Code) | `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` | `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json` | `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
+| Trae | `~/.trae/mcp.json` | `~/.trae/mcp.json` | `~/.trae/mcp.json` |
+| Qwen Code | `~/.qwen/settings.json` | `~/.qwen/settings.json` | `~/.qwen/settings.json` |
+| Kimi Code | `~/.kimi-code/mcp.json` | `~/.kimi-code/mcp.json` | `~/.kimi-code/mcp.json` |
+| DeepSeek | `~/.deepseek/mcp.json` | `~/.deepseek/mcp.json` | `~/.deepseek/mcp.json` |
+
+### 2. Clear the npx cache
+
+The MCP server binary is cached by npx. To remove it:
+
+```bash
+# macOS / Linux
+npx -y clear-npx-cache
+# or manually:
+rm -rf ~/.npm/_npx
+
+# Windows (PowerShell)
+Remove-Item -Recurse -Force "$env:USERPROFILE\.npm\_npx"
+```
+
+### 3. Revoke your API key
+
+Your elastic.io API key is stored in plain text in each config file listed above. After removing the config entries:
+
+1. Log in to your elastic.io account
+2. Go to your profile page
+3. Regenerate your API key
+
+This invalidates the old key even if a copy remains on disk.
+
+> **Security note:** Keep your MCP credentials secret and revoke them without delay if you suspect they may have been compromised.
+
+### 4. Restart your AI clients
+
+Restart any AI clients that were configured to pick up the changes.
+
+---
+
+## Licence
+
+This package is open-source under the [Apache 2.0](./LICENSE) licence. Connecting it to the elastic.io platform is subject to the Terms of Use above.

package/dist/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AA+B7C,qBAAa,iBAAkB,SAAQ,KAAK;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,GAAG,EAAE,CAAC;gBAET,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM;CAQnF;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAK5B;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAuF5F"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AA+B7C,qBAAa,iBAAkB,SAAQ,KAAK;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,GAAG,EAAE,CAAC;gBAET,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM;CAQnF;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAK5B;AAMD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAyF5F"}

package/dist/api/client.js

@@ -24,7 +24,7 @@ function formatPayloadForLog(data) {
         }
         return ` - Payload: ${str}`;
     }
-    catch (err) {
+    catch {
         return ' - Payload: [Error formatting payload]';
     }
 }
@@ -48,8 +48,11 @@ export class ElasticioNetworkError extends Error {
         Object.setPrototypeOf(this, ElasticioNetworkError.prototype);
     }
 }
+function ensureV2Suffix(url) {
+    return url.endsWith('/v2') ? url : `${url.replace(/\/+$/, '')}/v2`;
+}
 export function createElasticioClient(authHeader, apiBaseUrl) {
-    const baseURL = apiBaseUrl || process.env.ELASTICIO_API_BASE_URL || DEFAULT_BASE_URL;
+    const baseURL = ensureV2Suffix(apiBaseUrl || process.env.ELASTICIO_API_BASE_URL || DEFAULT_BASE_URL);
     const client = axios.create({
         baseURL,
         timeout: 30000,
@@ -79,7 +82,9 @@ export function createElasticioClient(authHeader, apiBaseUrl) {
             const configWithRetry = config;
             configWithRetry.__retryCount = configWithRetry.__retryCount || 0;
             const maxRetries = 3;
-            if ((isRateLimit || isTransientError || isNetworkOrTimeout) && configWithRetry.__retryCount < maxRetries) {
+            // A timeout on a write is ambiguous: replaying POST/PATCH can duplicate effects.
+            const safeToRetry = ['get', 'head', 'options'].includes(String(config.method || 'get').toLowerCase());
+            if (safeToRetry && (isRateLimit || isTransientError || isNetworkOrTimeout) && configWithRetry.__retryCount < maxRetries) {
                 configWithRetry.__retryCount += 1;
                 const delay = Math.pow(2, configWithRetry.__retryCount) * 1000;
                 logger.warn(`[HTTP Retry] ${isNetworkOrTimeout ? 'Network/Timeout Error' : `Status ${status}`} on ${config.method?.toUpperCase()} ${config.url}. Retrying in ${delay / 1000}s (Attempt ${configWithRetry.__retryCount}/${maxRetries})...`);

package/dist/api/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/api/jsonapi.d.ts

@@ -1,4 +1,4 @@
-export interface PaginationMeta {
+interface PaginationMeta {
     page: number;
     perPage: number;
     totalPages: number;
@@ -17,12 +17,5 @@ export declare function deserializeJsonApi<T = any>(payload: any): T;
  * Deserializes a JSON API response and preserves pagination metadata.
  */
 export declare function deserializeWithMeta<T = any>(payload: any): DeserializedResult<T>;
-/**
- * Serializes a clean JavaScript object into a JSON API compliant request payload.
- *
- * @param model The resource type (e.g., 'flows', 'workspaces')
- * @param data The payload data to serialize
- * @param method The HTTP method of the request ('POST', 'PATCH', etc.)
- */
-export declare function serializeJsonApi(model: string, data: any, method?: 'POST' | 'PATCH' | 'PUT' | 'GET'): any;
+export {};
 //# sourceMappingURL=jsonapi.d.ts.map

package/dist/api/jsonapi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonapi.d.ts","sourceRoot":"","sources":["../../src/api/jsonapi.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG;IACzC,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,CAM3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAehF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,KAAc,GAAG,GAAG,CAKjH"}
+{"version":3,"file":"jsonapi.d.ts","sourceRoot":"","sources":["../../src/api/jsonapi.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG;IACzC,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,CAM3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAehF"}

package/dist/api/jsonapi.js

@@ -1,4 +1,4 @@
-import { deserialise, serialise } from 'kitsu-core';
+import { deserialise } from 'kitsu-core';
 /**
  * Deserializes a JSON API response payload (with data, attributes, relationships, etc.)
  * into a clean JavaScript object or array of objects.
@@ -29,17 +29,4 @@ export function deserializeWithMeta(payload) {
         } : undefined
     };
 }
-/**
- * Serializes a clean JavaScript object into a JSON API compliant request payload.
- *
- * @param model The resource type (e.g., 'flows', 'workspaces')
- * @param data The payload data to serialize
- * @param method The HTTP method of the request ('POST', 'PATCH', etc.)
- */
-export function serializeJsonApi(model, data, method = 'POST') {
-    return serialise(model, data, method, {
-        camelCaseTypes: (s) => s,
-        pluralTypes: (s) => s
-    });
-}
 //# sourceMappingURL=jsonapi.js.map

package/dist/api/jsonapi.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsonapi.js","sourceRoot":"","sources":["../../src/api/jsonapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAcpD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAU,OAAY;IACtD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,IAAS,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAU,OAAY;IACvD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;IACpC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAS;QACtB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;YACf,IAAI,EAAE,QAAQ,CAAC,MAAM,IAAI,CAAC;YAC1B,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,IAAI,CAAC;YAC7C,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACzE,KAAK,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;SACjC,CAAC,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,IAAS,EAAE,SAA2C,MAAM;IAC1G,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;QACpC,cAAc,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC;QAChC,WAAW,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"jsonapi.js","sourceRoot":"","sources":["../../src/api/jsonapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAczC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAU,OAAY;IACtD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,IAAS,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAU,OAAY;IACvD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;IACpC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAS;QACtB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;YACf,IAAI,EAAE,QAAQ,CAAC,MAAM,IAAI,CAAC;YAC1B,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,IAAI,CAAC;YAC7C,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACzE,KAAK,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;SACjC,CAAC,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC"}

package/dist/api/logger.d.ts

@@ -5,5 +5,4 @@ export declare const logger: {
     warn: (message: string, ...args: any[]) => void;
     error: (message: string, ...args: any[]) => void;
 };
-export declare function logMcp(message: string): void;
 //# sourceMappingURL=logger.d.ts.map

package/dist/api/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/api/logger.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AA2C3D,eAAO,MAAM,MAAM;qBACA,MAAM,WAAW,GAAG,EAAE;oBACvB,MAAM,WAAW,GAAG,EAAE;oBACtB,MAAM,WAAW,GAAG,EAAE;qBACrB,MAAM,WAAW,GAAG,EAAE;CACxC,CAAC;AAGF,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,QAErC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/api/logger.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AA2C3D,eAAO,MAAM,MAAM;qBACA,MAAM,WAAW,GAAG,EAAE;oBACvB,MAAM,WAAW,GAAG,EAAE;oBACtB,MAAM,WAAW,GAAG,EAAE;qBACrB,MAAM,WAAW,GAAG,EAAE;CACxC,CAAC"}

package/dist/api/logger.js

@@ -1,4 +1,5 @@
-import fs from 'fs';
+import fs from 'node:fs';
+import process from 'node:process';
 // Write to file only when LOG_FILE env var is set (for local development)
 const LOG_FILE = process.env.LOG_FILE;
 const LogLevels = {
@@ -39,8 +40,4 @@ export const logger = {
     warn: (message, ...args) => writeLog('WARN', message, ...args),
     error: (message, ...args) => writeLog('ERROR', message, ...args),
 };
-// Maintain compatibility with existing code calling logMcp
-export function logMcp(message) {
-    logger.info(message);
-}
 //# sourceMappingURL=logger.js.map