@elastic.io/mcp 1.0.1-dev19 → 1.0.1-dev21

package/README.md

@@ -12,19 +12,32 @@ Published on npm as `@elastic.io/mcp`.
 
 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** — your account email and API key
+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. Ask for your elastic.io email and API key
+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
@@ -112,10 +125,16 @@ By default, documentation and flow sample searches are routed through the elasti
 
 To install and configure a local development version:
 
+**macOS / Linux:**
 ```
 npx -y @elastic.io/mcp@dev setup
 ```
 
+**Windows (PowerShell):**
+```powershell
+npx -y "@elastic.io/mcp@dev" setup
+```
+
 This installs the latest dev build from npm and runs the same setup wizard — it will ask for your credentials, detect installed AI clients, and write the config files pointing to the `@elastic.io/mcp@dev` tag.
 
 ### Built-in Safeguards

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAOnG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAqUhE;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,eAAe,CAA6B;IAEpD,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAInD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIlD,aAAa,CAAC,SAAS,EAAE,MAAM;IAU/B,kBAAkB,IAAI,MAAM;IAI5B,WAAW,CAAC,SAAS,GAAE,MAAuB;IAgB9C,UAAU;CAMX"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAOnG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAwVhE;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,eAAe,CAA6B;IAEpD,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAInD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIlD,aAAa,CAAC,SAAS,EAAE,MAAM;IAU/B,kBAAkB,IAAI,MAAM;IAI5B,WAAW,CAAC,SAAS,GAAE,MAAuB;IAgB9C,UAAU;CAMX"}

package/dist/server.js

@@ -46,6 +46,12 @@ export function createMcpServer(client) {
                     name: 'elastic.io Standardized Actions and Triggers Guide',
                     mimeType: 'text/markdown',
                     description: 'Specifications and usage guidelines for standardized actions and triggers across components.'
+                },
+                {
+                    uri: 'elasticio://docs/rest-api-pagination',
+                    name: 'Implementing Pagination with the REST API Component',
+                    mimeType: 'text/markdown',
+                    description: 'How to implement pagination with the REST API component using a recursive Flow Linking pattern, since the HTTP Request action does not support automatic pagination.'
                 }
             ]
         };
@@ -81,6 +87,19 @@ export function createMcpServer(client) {
                 ]
             };
         }
+        if (uri === 'elasticio://docs/rest-api-pagination') {
+            const filePath = resolveFromRoot('resources/docs/rest-api-pagination.md');
+            const text = fs.readFileSync(filePath, 'utf8');
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'text/markdown',
+                        text
+                    }
+                ]
+            };
+        }
         throw new Error(`Resource not found: ${uri}`);
     });
     // eslint-disable-next-line @typescript-eslint/require-await

package/dist/server.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elastic.io/mcp",
-  "version": "1.0.1-dev19",
+  "version": "1.0.1-dev21",
   "description": "elastic.io Model Context Protocol (MCP) Server",
   "main": "dist/index.js",
   "bin": {

package/resources/docs/rest-api-pagination.md

@@ -0,0 +1,58 @@
+# Implementing Pagination with the REST API Component
+
+The REST API component's `HTTP Request (Axios Library)` action does not provide automatic pagination or automatically retrieve subsequent pages. To retrieve all available records, implement pagination logic directly in your integration flow using a recursive flow execution pattern.
+
+The pagination mechanism depends on the target REST API. It may provide a next-page URL, a cursor, a page number, an offset, or another pagination parameter. Always follow the pagination mechanism documented by the target API.
+
+## 1. Flow Linking: Receive pagination parameters
+
+Configure a Flow Linking trigger to receive the input required to execute a paginated request.
+
+The input should contain the initial request URL or parameters for the first execution. For subsequent executions, it should contain the pagination information extracted from the previous response.
+
+## 2. REST API: HTTP Request (Axios Library)
+
+Configure the REST API component with the `HTTP Request (Axios Library)` action to execute the HTTP request.
+
+- Set the HTTP method, URL, headers, authentication, and other required request parameters.
+- Use the initial URL or pagination parameters received from the Flow Linking trigger.
+- Execute the request and retrieve the response.
+
+The action provides the HTTP status code, response headers (`HTTPHeaders`), and response body (`responseBody`), unless the response is configured to be downloaded as an attachment.
+
+## 3. Filter or Router: Check whether another page is available
+
+Inspect the response body and, if applicable, the response headers to determine whether more records are available.
+
+Use the pagination mechanism supported by the target API. For example:
+
+- **Next-page URL**: Check whether the response contains a next-page URL or link.
+- **Cursor-based pagination**: Check whether the response contains a continuation cursor or token.
+- **Offset-based pagination**: Check whether the API indicates that additional records are available and calculate the next offset.
+- **Page-based pagination**: Check whether another page exists and increment the page number.
+
+If another page is available, continue to the next step. Otherwise, stop pagination because the last page has been reached.
+
+## 4. Flow Linking: Trigger the next execution
+
+If another page is available, use Flow Linking to trigger the same flow again.
+
+Pass the pagination information extracted from the previous response, such as the next-page URL, cursor, offset, or page number.
+
+The next execution must use this information to configure the subsequent REST API request.
+
+## 5. Repeat until all pages are retrieved
+
+Repeat the request and pagination-checking steps until the target API indicates that no more pages are available.
+
+Ensure that all retrieved records are processed or stored as required by the integration flow. If necessary, use additional steps to aggregate records from multiple responses.
+
+## Important considerations
+
+- Do not assume that all REST APIs use the same pagination mechanism or response structure.
+- Use the pagination parameters and continuation indicators documented by the target API.
+- Do not construct or modify pagination URLs when the API provides a complete next-page URL. Follow the returned URL as specified by the API.
+- Ensure that the pagination condition correctly identifies the last page to prevent unnecessary requests or infinite execution loops.
+- Consider API rate limits and execution constraints when implementing recursive requests. Configure appropriate delays between requests when necessary.
+
+This approach allows you to retrieve all available records from REST APIs that use pagination, even when automatic pagination is not supported by the REST API component.

package/resources/docs/system-instructions.md

@@ -64,14 +64,15 @@ You MUST NOT do any of the following. These are the most frequent errors:
     - The verification is asynchronous; `init_verify_credentials` returns an `executionId` immediately. You must subsequently call `get_scheduled_execution_result` with this `executionId` to check the verification status. If the returned status is 'pending', wait 2-3 seconds and call `get_scheduled_execution_result` again.
 13. **API Reference & Swagger**: The official elastic.io REST API OpenAPI/Swagger documentation is hosted at `https://api.elastic.io/docs/v2`. If you need to verify exact API schemas, JSON payload formats, endpoint paths, or query parameters, you should refer to this URL.
 14. **Code Component Restriction (CRITICAL)**: The Node.js Code component (`elasticio/code`) must ONLY be used when the user explicitly requests custom code logic or when no suitable connector component exists for the task. You are strictly PROHIBITED from substituting real connector components (Salesforce, Shopify, Stripe, PostgreSQL, etc.) with code components that simulate their behavior. If a user asks to integrate with a specific system (e.g., "sync Salesforce to Shopify"), you MUST discover and use the actual platform connectors for those systems, including proper credential/secret setup. If credentials are missing, STOP and ask the user to provide or create them — do NOT fall back to a code component that simulates the connector.
-15. **Guided Flow Creation (CRITICAL)**: When creating a new flow, you MUST follow an interactive, step-by-step approach. Do NOT attempt to build the entire flow in a single tool call. Instead:
+15. **REST API Pagination (CRITICAL)**: The REST API component's `HTTP Request (Axios Library)` action does NOT support automatic pagination. When a user needs to paginate through REST API results (e.g., OData `@odata.nextLink`, cursor-based, offset-based, or page-number-based pagination), you MUST proactively suggest the recursive Flow Linking pattern described in `elasticio://docs/rest-api-pagination`. Read this resource and walk the user through building a self-calling flow that uses Flow Linking to pass pagination parameters back to itself. Do NOT suggest using the Code component to implement pagination loops — the standard pattern uses only visual connectors (Flow Linking trigger, REST API action, Filter/Router).
+16. **Guided Flow Creation (CRITICAL)**: When creating a new flow, you MUST follow an interactive, step-by-step approach. Do NOT attempt to build the entire flow in a single tool call. Instead:
     - **Step 1**: Ask the user what systems they want to connect and what the flow should do.
     - **Step 2**: For EACH step in the flow, discover the appropriate component, present options if multiple exist, and wait for user confirmation.
     - **Step 3**: For EACH component that requires credentials/secrets, check if they exist in the workspace. If not, STOP and guide the user through credential creation.
     - **Step 4**: For EACH component with dynamic select models or dynamic metadata, resolve them interactively — present the options to the user and let them choose (e.g., "Which Salesforce object type? Account, Contact, Lead...").
     - **Step 5**: Only after ALL steps are confirmed and configured, construct and submit the final flow payload.
     - At every decision point, STOP and ask the user. Never guess or assume. The goal is to guide the user like a wizard — one question at a time until every detail is resolved.
-16. **Dedicated Tools First with Fallback / Escape Hatch (CRITICAL)**:
+17. **Dedicated Tools First with Fallback / Escape Hatch (CRITICAL)**:
     - **Primary Choice**: Always prioritize using dedicated, specialized tools (`list_flows`, `get_flow`, `create_flow`, `update_flow_draft`, `update_flow`, `list_workspaces`, `list_components`, `list_credentials`, `list_secrets`, `get_logs`, etc.). Dedicated tools manage platform state machines, draft revisions, discovery state, graph validation, and health checks.
     - **Escape Hatch / Fallback**: You may use `execute_raw_api_request` ONLY in the following situations:
       1. When the desired operation or API endpoint is not supported by any dedicated MCP tool (e.g. edge-case endpoints like `/flows/{id}/errors`, custom admin/user endpoints).