@runapi.ai/hailuo-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,50 @@
+# @runapi.ai/hailuo-mcp
+
+RunAPI MCP server for the **Hailuo** model line. Create tasks,
+poll their status, and check pricing through a single RunAPI API key.
+
+## Tools
+
+- `image_to_video` — create a Hailuo task (image to video) and (optionally) poll until it reaches a terminal status. Returns the task id, status, output URLs, and a price snapshot. Models: `hailuo-02-image-to-video-pro`, `hailuo-02-image-to-video-standard`, `hailuo-2.3-image-to-video-pro`, `hailuo-2.3-image-to-video-standard`, `hailuo-02-text-to-video-pro`, `hailuo-02-text-to-video-standard`.
+- `text_to_video` — create a Hailuo task (text to video) and (optionally) poll until it reaches a terminal status. Returns the task id, status, output URLs, and a price snapshot. Models: `hailuo-02-image-to-video-pro`, `hailuo-02-image-to-video-standard`, `hailuo-2.3-image-to-video-pro`, `hailuo-2.3-image-to-video-standard`, `hailuo-02-text-to-video-pro`, `hailuo-02-text-to-video-standard`.
+- `get_task` — fetch the current status and latest payload for a task.
+- `check_pricing` — look up pricing for a model in this line.
+
+## Configuration
+
+Set a RunAPI API key via the `RUNAPI_API_KEY` environment variable, or write
+it to `~/.config/runapi/config.json`:
+
+```bash
+mkdir -p ~/.config/runapi
+echo '{"api_key":"YOUR_KEY"}' > ~/.config/runapi/config.json
+```
+
+Get an API key at https://runapi.ai. Pricing is listed at
+https://runapi.ai/pricing.
+
+## Usage
+
+Run the server over stdio:
+
+```bash
+npx -y @runapi.ai/hailuo-mcp
+```
+
+Add it to an MCP client (see `examples/` for per-client configs):
+
+```json
+{
+  "mcpServers": {
+    "hailuo": {
+      "command": "npx",
+      "args": ["-y", "@runapi.ai/hailuo-mcp"],
+      "env": { "RUNAPI_API_KEY": "${RUNAPI_API_KEY}" }
+    }
+  }
+}
+```
+
+## License
+
+Apache-2.0

package/data/contract.json

@@ -0,0 +1,101 @@
+{
+  "catalog_models": [
+    "hailuo-02-image-to-video-pro",
+    "hailuo-02-image-to-video-standard",
+    "hailuo-2.3-image-to-video-pro",
+    "hailuo-2.3-image-to-video-standard",
+    "hailuo-02-text-to-video-pro",
+    "hailuo-02-text-to-video-standard"
+  ],
+  "actions": {
+    "hailuo/image-to-video": {
+      "model": "Hailuo",
+      "endpoint": "image_to_video",
+      "models": [
+        "hailuo-02-image-to-video-pro",
+        "hailuo-02-image-to-video-standard",
+        "hailuo-2.3-image-to-video-pro",
+        "hailuo-2.3-image-to-video-standard"
+      ],
+      "fields_by_model": {
+        "hailuo-02-image-to-video-pro": {
+          "last_frame_image_url": {},
+          "first_frame_image_url": {
+            "required": true
+          }
+        },
+        "hailuo-02-image-to-video-standard": {
+          "duration_seconds": {
+            "enum": [
+              6,
+              10
+            ]
+          },
+          "output_resolution": {
+            "enum": [
+              "512p",
+              "768p"
+            ]
+          },
+          "last_frame_image_url": {},
+          "first_frame_image_url": {
+            "required": true
+          }
+        },
+        "hailuo-2.3-image-to-video-pro": {
+          "duration_seconds": {
+            "enum": [
+              6,
+              10
+            ]
+          },
+          "output_resolution": {
+            "enum": [
+              "768p",
+              "1080p"
+            ]
+          },
+          "first_frame_image_url": {
+            "required": true
+          }
+        },
+        "hailuo-2.3-image-to-video-standard": {
+          "duration_seconds": {
+            "enum": [
+              6,
+              10
+            ]
+          },
+          "output_resolution": {
+            "enum": [
+              "768p",
+              "1080p"
+            ]
+          },
+          "first_frame_image_url": {
+            "required": true
+          }
+        }
+      }
+    },
+    "hailuo/text-to-video": {
+      "model": "Hailuo",
+      "endpoint": "text_to_video",
+      "models": [
+        "hailuo-02-text-to-video-pro",
+        "hailuo-02-text-to-video-standard"
+      ],
+      "fields_by_model": {
+        "hailuo-02-text-to-video-pro": {},
+        "hailuo-02-text-to-video-standard": {
+          "duration_seconds": {
+            "enum": [
+              6,
+              10
+            ]
+          }
+        }
+      }
+    }
+  }
+}

package/data/pricing.json

@@ -0,0 +1,75 @@
+{
+  "endpoints": {
+    "hailuo-02-image-to-video-pro/image_to_video": {
+      "unit_price_cents": 57
+    },
+    "hailuo-02-image-to-video-standard/image_to_video": {
+      "unit_price_cents": 30,
+      "billing_config": {
+        "keys": [
+          "duration_seconds",
+          "output_resolution"
+        ],
+        "matrix": {
+          "6": {
+            "512p": 12,
+            "768p": 30
+          },
+          "10": {
+            "512p": 20,
+            "768p": 50
+          }
+        }
+      }
+    },
+    "hailuo-2.3-image-to-video-pro/image_to_video": {
+      "unit_price_cents": 90,
+      "billing_config": {
+        "keys": [
+          "duration_seconds",
+          "output_resolution"
+        ],
+        "matrix": {
+          "6": {
+            "768p": 45,
+            "1080p": 80
+          },
+          "10": {
+            "768p": 90
+          }
+        }
+      }
+    },
+    "hailuo-2.3-image-to-video-standard/image_to_video": {
+      "unit_price_cents": 50,
+      "billing_config": {
+        "keys": [
+          "duration_seconds",
+          "output_resolution"
+        ],
+        "matrix": {
+          "6": {
+            "768p": 30,
+            "1080p": 50
+          },
+          "10": {
+            "768p": 50
+          }
+        }
+      }
+    },
+    "hailuo-02-text-to-video-pro/text_to_video": {
+      "unit_price_cents": 57
+    },
+    "hailuo-02-text-to-video-standard/text_to_video": {
+      "unit_price_cents": 50,
+      "billing_config": {
+        "key": "duration_seconds",
+        "overrides": {
+          "6": 30,
+          "10": 50
+        }
+      }
+    }
+  }
+}

package/dist/bin/hailuo-mcp.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../src/index.js";

package/dist/bin/hailuo-mcp.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "../src/index.js";
+//# sourceMappingURL=hailuo-mcp.js.map

package/dist/bin/hailuo-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hailuo-mcp.js","sourceRoot":"","sources":["../../bin/hailuo-mcp.ts"],"names":[],"mappings":";AACA,OAAO,iBAAiB,CAAC"}

package/dist/src/data.d.ts

@@ -0,0 +1,3 @@
+import type { Contract, PricingConfig } from "@runapi.ai/mcp-core";
+export declare function readContract(): Contract;
+export declare function readPricing(): PricingConfig;

package/dist/src/data.js

@@ -0,0 +1,22 @@
+import { existsSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+function dataRoot() {
+    const current = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        path.resolve(current, "..", "..", "data"),
+        path.resolve(current, "..", "data")
+    ];
+    const root = candidates.find((candidate) => existsSync(path.join(candidate, "contract.json")));
+    if (!root) {
+        throw new Error("Unable to locate the embedded RunAPI data directory.");
+    }
+    return root;
+}
+export function readContract() {
+    return JSON.parse(readFileSync(path.join(dataRoot(), "contract.json"), "utf8"));
+}
+export function readPricing() {
+    return JSON.parse(readFileSync(path.join(dataRoot(), "pricing.json"), "utf8"));
+}
+//# sourceMappingURL=data.js.map

package/dist/src/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../src/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,SAAS,QAAQ;IACf,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC;KACpC,CAAC;IAEF,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/F,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAa,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAkB,CAAC;AAClG,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const server = createServer();
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/src/meta.d.ts

@@ -0,0 +1,5 @@
+export declare const META: {
+    readonly name: "@runapi.ai/hailuo-mcp";
+    readonly version: "0.1.0";
+    readonly lineSlug: "hailuo";
+};

package/dist/src/meta.js

@@ -0,0 +1,6 @@
+export const META = {
+    name: "@runapi.ai/hailuo-mcp",
+    version: "0.1.0",
+    lineSlug: "hailuo"
+};
+//# sourceMappingURL=meta.js.map

package/dist/src/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/meta.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,QAAQ;CACV,CAAC"}

package/dist/src/server.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/src/server.js

@@ -0,0 +1,123 @@
+import { z } from "zod";
+import { createModelServer, findModelForAction, findModels, friendlyError, jsonText, priceForModel, RunApiClient, taskStatus } from "@runapi.ai/mcp-core";
+import { readContract, readPricing } from "./data.js";
+import { META } from "./meta.js";
+function lineService(contract) {
+    return Object.keys(contract.actions)[0]?.split("/")[0] ?? META.lineSlug;
+}
+function lineEndpoints(contract) {
+    const seen = new Set();
+    for (const action of Object.values(contract.actions)) {
+        seen.add(action.endpoint);
+    }
+    return [...seen];
+}
+function lineModels(contract) {
+    const seen = new Set();
+    for (const action of Object.values(contract.actions)) {
+        for (const model of action.models) {
+            seen.add(model);
+        }
+    }
+    return [...seen];
+}
+function rulesForAction(action) {
+    return action.rules ?? [];
+}
+function buildTools(contract) {
+    const tools = [];
+    const inputRules = {};
+    for (const [key, action] of Object.entries(contract.actions)) {
+        const service = key.split("/")[0];
+        const endpoint = action.endpoint;
+        tools.push({
+            name: endpoint,
+            description: `Create a ${action.model} task on RunAPI (${endpoint.replace(/_/g, " ")}). Returns a task id, status, and output URLs.`,
+            service,
+            action: endpoint,
+            models: action.models
+        });
+        inputRules[endpoint] = rulesForAction(action);
+    }
+    return { tools, inputRules };
+}
+function registerLineTools(server, contract, pricing, client) {
+    const service = lineService(contract);
+    const endpoints = lineEndpoints(contract);
+    const models = lineModels(contract);
+    const endpointEnum = endpoints.length > 0 ? z.enum(endpoints) : z.string();
+    const modelEnum = models.length > 0 ? z.enum(models) : z.string();
+    // With one endpoint, action defaults safely. With several, a wrong default
+    // would query the wrong task route, so the caller must name the endpoint.
+    const getTaskAction = endpoints.length > 1
+        ? endpointEnum.describe("Endpoint the task was created on.")
+        : endpointEnum.optional().describe("Endpoint the task was created on. Defaults to the line's only endpoint.");
+    server.tool("get_task", `Fetch the current status and latest result payload for a ${META.lineSlug} task.`, {
+        task_id: z.string().describe("Task id returned when the task was created."),
+        action: getTaskAction
+    }, async ({ task_id, action }) => {
+        try {
+            const task = await client.getTask(service, task_id, action ?? endpoints[0]);
+            return jsonText({ task_id, status: taskStatus(task), task });
+        }
+        catch (error) {
+            return jsonText({ error: friendlyError(error) });
+        }
+    });
+    server.tool("check_pricing", `Look up RunAPI pricing for the ${META.lineSlug} model line.`, {
+        model: modelEnum.optional().describe("Model slug. Defaults to the line's primary model."),
+        action: endpointEnum.optional().describe("Endpoint name. Defaults to the endpoint that offers the model.")
+    }, async ({ model, action }) => {
+        const noMatch = { supported: false, message: "No matching model/endpoint in this model line." };
+        // Explicit endpoint: price exactly that model on that endpoint.
+        if (action) {
+            const info = findModelForAction(service, action, model, contract);
+            return info
+                ? jsonText({ supported: true, model: info.model, service: info.service, action: info.action, price: priceForModel(info, pricing) })
+                : jsonText(noMatch);
+        }
+        // No endpoint and no model: price the line's primary model/endpoint.
+        if (!model) {
+            const info = findModelForAction(service, endpoints[0], undefined, contract);
+            return info
+                ? jsonText({ supported: true, model: info.model, service: info.service, action: info.action, price: priceForModel(info, pricing) })
+                : jsonText(noMatch);
+        }
+        // No endpoint named: a model may be offered on several endpoints at
+        // different prices, so report every endpoint that offers it rather than
+        // silently pricing only the first one found.
+        const matches = findModels(model, contract);
+        if (matches.length === 0) {
+            return jsonText(noMatch);
+        }
+        if (matches.length === 1) {
+            const info = matches[0];
+            return jsonText({ supported: true, model: info.model, service: info.service, action: info.action, price: priceForModel(info, pricing) });
+        }
+        return jsonText({
+            supported: true,
+            model: matches[0].model,
+            service: matches[0].service,
+            endpoints: matches.map((info) => ({ action: info.action, price: priceForModel(info, pricing) }))
+        });
+    });
+}
+export function createServer() {
+    const contract = readContract();
+    const pricing = readPricing();
+    const { tools, inputRules } = buildTools(contract);
+    const client = new RunApiClient();
+    const server = createModelServer({
+        name: META.name,
+        version: META.version,
+        lineSlug: META.lineSlug,
+        contract,
+        pricing,
+        inputRules,
+        tools,
+        client
+    });
+    registerLineTools(server, contract, pricing, client);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/examples/claude.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "hailuo": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@runapi.ai/hailuo-mcp"
+      ],
+      "env": {
+        "RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
+      }
+    }
+  }
+}

package/examples/cursor.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "hailuo": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@runapi.ai/hailuo-mcp"
+      ],
+      "env": {
+        "RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
+      }
+    }
+  }
+}

package/examples/roo.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "hailuo": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@runapi.ai/hailuo-mcp"
+      ],
+      "env": {
+        "RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
+      }
+    }
+  }
+}

package/examples/vscode.mcp.json

@@ -0,0 +1,15 @@
+{
+  "servers": {
+    "hailuo": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "@runapi.ai/hailuo-mcp"
+      ],
+      "env": {
+        "RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
+      }
+    }
+  }
+}

package/examples/windsurf.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "hailuo": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@runapi.ai/hailuo-mcp"
+      ],
+      "env": {
+        "RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@runapi.ai/hailuo-mcp",
+  "version": "0.1.0",
+  "description": "RunAPI MCP server for one model line: create tasks, poll status, and check pricing with one API key.",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "bin": {
+    "hailuo-mcp": "dist/bin/hailuo-mcp.js"
+  },
+  "files": [
+    "dist",
+    "data/contract.json",
+    "data/pricing.json",
+    "examples",
+    "server.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "runapi",
+    "mcp",
+    "model-context-protocol",
+    "ai"
+  ],
+  "author": "RunAPI",
+  "license": "Apache-2.0",
+  "homepage": "https://runapi.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/runapi-ai/hailuo-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/runapi-ai/hailuo-mcp/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@runapi.ai/mcp-core": "0.1.2",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.14"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "mcpName": "io.github.runapi-builder/hailuo-mcp"
+}

package/server.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.runapi-builder/hailuo-mcp",
+  "description": "RunAPI MCP server for Hailuo: create tasks, poll status, and check pricing.",
+  "repository": {
+    "url": "https://github.com/runapi-ai/hailuo-mcp",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@runapi.ai/hailuo-mcp",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "description": "RunAPI API key. Get one at https://runapi.ai",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true,
+          "name": "RUNAPI_API_KEY"
+        }
+      ]
+    }
+  ]
+}