angel-one-mcp 1.0.7 → 1.0.8

package/build/config.d.ts

@@ -12,4 +12,8 @@ export interface Credentials {
 }
 export interface Config extends Credentials, SafetyConfig {
 }
+export declare const REQUIRED_ENV_VARS: readonly ["ANGEL_API_KEY", "ANGEL_CLIENT_ID", "ANGEL_PASSWORD", "ANGEL_TOTP_SECRET"];
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
 export declare function loadConfig(): Config;

package/build/config.js

@@ -1,17 +1,44 @@
+export const REQUIRED_ENV_VARS = [
+    "ANGEL_API_KEY",
+    "ANGEL_CLIENT_ID",
+    "ANGEL_PASSWORD",
+    "ANGEL_TOTP_SECRET",
+];
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+function formatMissingEnvMessage(missing) {
+    return [
+        "Missing required environment variables:",
+        ...missing.map((name) => `- ${name}`),
+        "",
+        "Set them in your MCP client config or a local .env file before starting the server.",
+        "Example:",
+        "ANGEL_API_KEY=your_smartapi_key",
+        "ANGEL_CLIENT_ID=your_client_id",
+        "ANGEL_PASSWORD=your_mpin",
+        "ANGEL_TOTP_SECRET=your_base32_totp_secret",
+    ].join("\n");
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new ConfigError(formatMissingEnvMessage([name]));
+    }
+    return value;
+}
 export function loadConfig() {
-    const apiKey = process.env.ANGEL_API_KEY;
-    const clientId = process.env.ANGEL_CLIENT_ID;
-    const password = process.env.ANGEL_PASSWORD;
-    const totpSecret = process.env.ANGEL_TOTP_SECRET;
-    if (!apiKey || !clientId || !password || !totpSecret) {
-        const missing = [
-            !apiKey && "ANGEL_API_KEY",
-            !clientId && "ANGEL_CLIENT_ID",
-            !password && "ANGEL_PASSWORD",
-            !totpSecret && "ANGEL_TOTP_SECRET",
-        ].filter(Boolean);
-        throw new Error(`Missing required env vars: ${missing.join(", ")}`);
+    const missing = REQUIRED_ENV_VARS.filter((name) => !process.env[name]);
+    if (missing.length > 0) {
+        throw new ConfigError(formatMissingEnvMessage(missing));
     }
+    const apiKey = requireEnv("ANGEL_API_KEY");
+    const clientId = requireEnv("ANGEL_CLIENT_ID");
+    const password = requireEnv("ANGEL_PASSWORD");
+    const totpSecret = requireEnv("ANGEL_TOTP_SECRET");
     const parseIntSafe = (name, val, fallback) => {
         if (!val)
             return fallback;
@@ -33,10 +60,10 @@ export function loadConfig() {
         hardMaxOrderValue: parseIntSafe("HARD_MAX_ORDER_VALUE", process.env.HARD_MAX_ORDER_VALUE, 100000),
     };
     if (config.softMaxOrderQty > config.hardMaxOrderQty) {
-        throw new Error(`SOFT_MAX_ORDER_QTY (${config.softMaxOrderQty}) must be ≤ HARD_MAX_ORDER_QTY (${config.hardMaxOrderQty})`);
+        throw new ConfigError(`SOFT_MAX_ORDER_QTY (${config.softMaxOrderQty}) must be ≤ HARD_MAX_ORDER_QTY (${config.hardMaxOrderQty})`);
     }
     if (config.softMaxOrderValue > config.hardMaxOrderValue) {
-        throw new Error(`SOFT_MAX_ORDER_VALUE (${config.softMaxOrderValue}) must be ≤ HARD_MAX_ORDER_VALUE (${config.hardMaxOrderValue})`);
+        throw new ConfigError(`SOFT_MAX_ORDER_VALUE (${config.softMaxOrderValue}) must be ≤ HARD_MAX_ORDER_VALUE (${config.hardMaxOrderValue})`);
     }
     return config;
 }

package/build/index.js

@@ -4,21 +4,72 @@ import { readFileSync } from "node:fs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { AngelOneAPI } from "./api.js";
-import { loadConfig } from "./config.js";
+import { ConfigError, REQUIRED_ENV_VARS, loadConfig } from "./config.js";
 import { registerAllTools } from "./tools/index.js";
 const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
-const config = loadConfig();
-const api = new AngelOneAPI(config);
-const safetyConfig = {
-    softMaxOrderQty: config.softMaxOrderQty,
-    hardMaxOrderQty: config.hardMaxOrderQty,
-    softMaxOrderValue: config.softMaxOrderValue,
-    hardMaxOrderValue: config.hardMaxOrderValue,
-};
-const server = new McpServer({
-    name: "angel-one",
-    version: pkg.version,
-});
-registerAllTools(server, api, safetyConfig);
-const transport = new StdioServerTransport();
-await server.connect(transport);
+const HELP_TEXT = `angel-one-mcp v${pkg.version}
+
+MCP stdio server for Angel One SmartAPI.
+
+Usage:
+  npx -y angel-one-mcp
+
+Required environment variables:
+${REQUIRED_ENV_VARS.map((name) => `  - ${name}`).join("\n")}
+
+Optional safety limits:
+  - SOFT_MAX_ORDER_QTY (default: 25)
+  - HARD_MAX_ORDER_QTY (default: 100)
+  - SOFT_MAX_ORDER_VALUE (default: 10000)
+  - HARD_MAX_ORDER_VALUE (default: 100000)
+
+Example MCP client config:
+{
+  "mcpServers": {
+    "angel-one": {
+      "command": "npx",
+      "args": ["-y", "angel-one-mcp"],
+      "env": {
+        "ANGEL_API_KEY": "your_smartapi_key",
+        "ANGEL_CLIENT_ID": "your_client_id",
+        "ANGEL_PASSWORD": "your_mpin",
+        "ANGEL_TOTP_SECRET": "your_base32_totp_secret"
+      }
+    }
+  }
+}
+`;
+function wantsHelp(args) {
+    return args.includes("--help") || args.includes("-h");
+}
+async function main() {
+    if (wantsHelp(process.argv.slice(2))) {
+        process.stdout.write(HELP_TEXT);
+        return;
+    }
+    const config = loadConfig();
+    const api = new AngelOneAPI(config);
+    const safetyConfig = {
+        softMaxOrderQty: config.softMaxOrderQty,
+        hardMaxOrderQty: config.hardMaxOrderQty,
+        softMaxOrderValue: config.softMaxOrderValue,
+        hardMaxOrderValue: config.hardMaxOrderValue,
+    };
+    const server = new McpServer({
+        name: "angel-one",
+        version: pkg.version,
+    });
+    registerAllTools(server, api, safetyConfig);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+try {
+    await main();
+}
+catch (error) {
+    if (error instanceof ConfigError) {
+        process.stderr.write(`${error.message}\n`);
+        process.exit(1);
+    }
+    throw error;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angel-one-mcp",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "MCP server for Angel One SmartAPI — trade stocks, track portfolio, analyze markets & manage orders via LLM clients like Claude, Cursor & Copilot",
   "type": "module",
   "bin": {