@zebpay_rajesh/zebpay-mcp-server 0.1.0

package/dist/validation/schemas.d.ts

@@ -0,0 +1,70 @@
+import { z } from "zod";
+export declare const sideEnum: z.ZodEnum<{
+    buy: "buy";
+    sell: "sell";
+}>;
+export declare const orderTypeEnum: z.ZodEnum<{
+    limit: "limit";
+    market: "market";
+}>;
+export declare const spotPlaceOrderInput: z.ZodObject<{
+    symbol: z.ZodString;
+    side: z.ZodEnum<{
+        buy: "buy";
+        sell: "sell";
+    }>;
+    type: z.ZodEnum<{
+        limit: "limit";
+        market: "market";
+    }>;
+    quantity: z.ZodString;
+    price: z.ZodOptional<z.ZodString>;
+    clientOrderId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const spotCancelOrderInput: z.ZodObject<{
+    orderId: z.ZodString;
+    symbol: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const spotBalancesOutput: z.ZodObject<{
+    balances: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        free: z.ZodString;
+        locked: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const futuresPlaceOrderInput: z.ZodObject<{
+    symbol: z.ZodString;
+    side: z.ZodEnum<{
+        buy: "buy";
+        sell: "sell";
+    }>;
+    type: z.ZodEnum<{
+        limit: "limit";
+        market: "market";
+    }>;
+    quantity: z.ZodString;
+    price: z.ZodOptional<z.ZodString>;
+    leverage: z.ZodOptional<z.ZodNumber>;
+    clientOrderId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const futuresCancelOrderInput: z.ZodObject<{
+    orderId: z.ZodString;
+    symbol: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const futuresPositionsOutput: z.ZodObject<{
+    positions: z.ZodArray<z.ZodObject<{
+        symbol: z.ZodString;
+        positionSide: z.ZodOptional<z.ZodEnum<{
+            long: "long";
+            short: "short";
+        }>>;
+        quantity: z.ZodString;
+        entryPrice: z.ZodOptional<z.ZodString>;
+        unrealizedPnl: z.ZodOptional<z.ZodString>;
+        leverage: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SpotPlaceOrderInput = z.infer<typeof spotPlaceOrderInput>;
+export type SpotCancelOrderInput = z.infer<typeof spotCancelOrderInput>;
+export type FuturesPlaceOrderInput = z.infer<typeof futuresPlaceOrderInput>;
+export type FuturesCancelOrderInput = z.infer<typeof futuresCancelOrderInput>;

package/dist/validation/schemas.js

@@ -0,0 +1,48 @@
+/*
+  Zod schemas for inputs/outputs. These validate tool params and normalize outputs.
+*/
+import { z } from "zod";
+// Shared enums
+export const sideEnum = z.enum(["buy", "sell"]);
+export const orderTypeEnum = z.enum(["market", "limit"]);
+// Spot
+export const spotPlaceOrderInput = z.object({
+    symbol: z.string().min(1),
+    side: sideEnum,
+    type: orderTypeEnum,
+    quantity: z.string().min(1),
+    price: z.string().optional(),
+    clientOrderId: z.string().optional(),
+});
+export const spotCancelOrderInput = z.object({
+    orderId: z.string().min(1),
+    symbol: z.string().optional(),
+});
+export const spotBalancesOutput = z.object({
+    balances: z.array(z.object({ asset: z.string(), free: z.string(), locked: z.string() })),
+});
+// Futures
+export const futuresPlaceOrderInput = z.object({
+    symbol: z.string().min(1),
+    side: sideEnum,
+    type: orderTypeEnum,
+    quantity: z.string().min(1),
+    price: z.string().optional(),
+    leverage: z.number().int().positive().max(125).optional(),
+    clientOrderId: z.string().optional(),
+});
+export const futuresCancelOrderInput = z.object({
+    orderId: z.string().min(1),
+    symbol: z.string().optional(),
+});
+export const futuresPositionsOutput = z.object({
+    positions: z.array(z.object({
+        symbol: z.string(),
+        positionSide: z.enum(["long", "short"]).optional(),
+        quantity: z.string(),
+        entryPrice: z.string().optional(),
+        unrealizedPnl: z.string().optional(),
+        leverage: z.number().int().positive().optional(),
+    })),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/validation/schemas.js.map

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

package/dist/validation/validators.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+/**
+ * Validates trading pair symbol format (BASE-QUOTE)
+ * Examples: BTC-INR, ETH-INR, BTC-USDT
+ */
+export declare function validateSymbol(symbol: string): void;
+/**
+ * Validates quantity string format
+ */
+export declare function validateQuantity(quantity: string): void;
+/**
+ * Zod schema for symbol validation
+ */
+export declare const symbolSchema: z.ZodString;
+/**
+ * Zod schema for quantity validation
+ */
+export declare const quantitySchema: z.ZodString;
+/**
+ * Validates clientOrderId format
+ * Must contain only letters, numbers, dots, colons, slashes, underscores, and hyphens
+ * Length must be between 1-36 characters
+ */
+export declare function validateClientOrderId(clientOrderId: string): void;
+/**
+ * Zod schema for clientOrderId validation
+ */
+export declare const clientOrderIdSchema: z.ZodString;

package/dist/validation/validators.js

@@ -0,0 +1,129 @@
+/*
+  Input validation helpers with helpful error messages for LLMs.
+*/
+import { z } from "zod";
+import { createInvalidParamsError } from "../mcp/errors.js";
+/**
+ * Validates trading pair symbol format (BASE-QUOTE)
+ * Examples: BTC-INR, ETH-INR, BTC-USDT
+ */
+export function validateSymbol(symbol) {
+    if (!symbol || typeof symbol !== "string") {
+        throw createInvalidParamsError(`Invalid symbol: must be a non-empty string. Expected format: BASE-QUOTE (e.g., "BTC-INR", "ETH-INR")`);
+    }
+    const trimmed = symbol.trim().toUpperCase();
+    const parts = trimmed.split("-");
+    if (parts.length !== 2) {
+        throw createInvalidParamsError(`Invalid symbol format: "${symbol}". Expected format: BASE-QUOTE (e.g., "BTC-INR", "ETH-INR", "BTC-USDT"). Use uppercase currency codes separated by a single hyphen.`);
+    }
+    const [base, quote] = parts;
+    if (!base || base.length === 0) {
+        throw createInvalidParamsError(`Invalid symbol: base currency is missing. Expected format: BASE-QUOTE (e.g., "BTC-INR")`);
+    }
+    if (!quote || quote.length === 0) {
+        throw createInvalidParamsError(`Invalid symbol: quote currency is missing. Expected format: BASE-QUOTE (e.g., "BTC-INR")`);
+    }
+    // Check for valid currency code format (alphanumeric, typically 2-10 characters)
+    const currencyCodeRegex = /^[A-Z0-9]{2,10}$/;
+    if (!currencyCodeRegex.test(base)) {
+        throw createInvalidParamsError(`Invalid base currency code: "${base}". Currency codes should be 2-10 uppercase alphanumeric characters (e.g., "BTC", "ETH", "USDT")`);
+    }
+    if (!currencyCodeRegex.test(quote)) {
+        throw createInvalidParamsError(`Invalid quote currency code: "${quote}". Currency codes should be 2-10 uppercase alphanumeric characters (e.g., "INR", "USDT", "BTC")`);
+    }
+}
+/**
+ * Validates quantity string format
+ */
+export function validateQuantity(quantity) {
+    if (!quantity || typeof quantity !== "string") {
+        throw createInvalidParamsError(`Invalid quantity: must be a non-empty string. This prevents floating-point precision issues. Example: "0.001" or "100"`);
+    }
+    const trimmed = quantity.trim();
+    if (trimmed.length === 0) {
+        throw createInvalidParamsError(`Invalid quantity: cannot be empty. Provide a positive number as a string (e.g., "0.001", "100", "0.5")`);
+    }
+    // Check if it's a valid number format
+    const numberRegex = /^-?\d+(\.\d+)?$/;
+    if (!numberRegex.test(trimmed)) {
+        throw createInvalidParamsError(`Invalid quantity format: "${quantity}". Expected a positive number as a string. Examples: "0.001", "100", "0.5". Do not include commas or other formatting.`);
+    }
+    // Check if it's positive
+    const numValue = parseFloat(trimmed);
+    if (isNaN(numValue)) {
+        throw createInvalidParamsError(`Invalid quantity: "${quantity}" is not a valid number. Provide a positive number as a string (e.g., "0.001")`);
+    }
+    if (numValue <= 0) {
+        throw createInvalidParamsError(`Invalid quantity: "${quantity}" must be greater than zero. Provide a positive number as a string (e.g., "0.001", "100")`);
+    }
+    // Check for reasonable precision (typically up to 8 decimal places for crypto)
+    const decimalParts = trimmed.split(".");
+    if (decimalParts.length === 2 && decimalParts[1].length > 18) {
+        throw createInvalidParamsError(`Invalid quantity precision: "${quantity}" has too many decimal places (max 18). Example: "0.001" or "100.123456789012345678"`);
+    }
+}
+/**
+ * Zod schema for symbol validation
+ */
+export const symbolSchema = z.string().min(1).refine((val) => {
+    try {
+        validateSymbol(val);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, {
+    message: 'Invalid symbol format. Expected BASE-QUOTE (e.g., "BTC-INR", "ETH-INR")',
+});
+/**
+ * Zod schema for quantity validation
+ */
+export const quantitySchema = z.string().min(1).refine((val) => {
+    try {
+        validateQuantity(val);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, {
+    message: 'Invalid quantity format. Expected a positive number as a string (e.g., "0.001", "100")',
+});
+/**
+ * Validates clientOrderId format
+ * Must contain only letters, numbers, dots, colons, slashes, underscores, and hyphens
+ * Length must be between 1-36 characters
+ */
+export function validateClientOrderId(clientOrderId) {
+    if (!clientOrderId || typeof clientOrderId !== "string") {
+        throw createInvalidParamsError(`Invalid clientOrderId: must be a non-empty string`);
+    }
+    const trimmed = clientOrderId.trim();
+    if (trimmed.length === 0) {
+        throw createInvalidParamsError(`Invalid clientOrderId: cannot be empty`);
+    }
+    if (trimmed.length > 36) {
+        throw createInvalidParamsError(`Invalid clientOrderId: "${clientOrderId}" exceeds maximum length of 36 characters (current: ${trimmed.length})`);
+    }
+    // Must contain only letters, numbers, dots, colons, slashes, underscores, and hyphens
+    const validFormat = /^[a-zA-Z0-9.:/_\-]+$/;
+    if (!validFormat.test(trimmed)) {
+        throw createInvalidParamsError(`Invalid clientOrderId format: "${clientOrderId}". Must contain only letters, numbers, dots, colons, slashes, underscores, and hyphens. Examples: "my-order-123", "order:2024/01/15_001", "trade.abc-123"`);
+    }
+}
+/**
+ * Zod schema for clientOrderId validation
+ */
+export const clientOrderIdSchema = z.string().min(1).max(36).refine((val) => {
+    try {
+        validateClientOrderId(val);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, {
+    message: 'Invalid clientOrderId format. Must be 1-36 characters and contain only letters, numbers, dots, colons, slashes, underscores, and hyphens',
+});
+//# sourceMappingURL=validators.js.map

package/dist/validation/validators.js.map

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

package/docs/LOGGING.md

@@ -0,0 +1,371 @@
+# 📋 Logging & Request/Response Tracking Guide
+
+This guide shows you how to easily track and analyze all API requests and responses without dealing with messy console.log output.
+
+## 🚀 Quick Start
+
+### View All Logs (Pretty Format)
+```bash
+npm run logs
+```
+
+### Watch Logs in Real-Time (Live Updates)
+```bash
+npm run logs:watch
+```
+
+### View Only Errors
+```bash
+npm run logs:errors
+```
+
+### View Statistics Dashboard
+```bash
+npm run logs:stats
+```
+
+---
+
+## 📊 Log Viewer Commands
+
+The log viewer provides powerful filtering and formatting capabilities:
+
+### Basic Usage
+
+```bash
+# View all logs (formatted and colored)
+npm run logs
+
+# View only HTTP requests/responses
+npm run logs:http
+
+# View only MCP tool calls
+npm run logs:mcp
+
+# View only errors
+npm run logs:errors
+
+# Watch logs live (tail -f style)
+npm run logs:watch
+```
+
+### Advanced Filtering
+
+```bash
+# Filter by trading symbol
+node scripts/log-viewer.js --symbol=BTC-INR
+
+# Filter by specific tool
+node scripts/log-viewer.js --tool=zebpay_spot_placeMarketOrder
+
+# Show last 50 entries
+node scripts/log-viewer.js --last=50
+
+# Filter by correlation ID (track a specific request through the system)
+node scripts/log-viewer.js --correlation=abc123def456
+
+# Combine filters
+node scripts/log-viewer.js --type=http --errors --last=20
+
+# Watch with filters
+node scripts/log-viewer.js --symbol=BTC-INR --watch
+```
+
+### Output Options
+
+```bash
+# Raw JSON output (for piping to other tools)
+node scripts/log-viewer.js --raw
+
+# Show help
+node scripts/log-viewer.js --help
+```
+
+---
+
+## 📈 Log Statistics Dashboard
+
+Get a comprehensive overview of all API activity:
+
+```bash
+npm run logs:stats
+```
+
+**Shows:**
+- 📊 Total requests, responses, and errors
+- 🌐 HTTP statistics (by method, status code, average duration)
+- 🔧 MCP tool usage statistics
+- 📈 Trading symbols usage
+- ⚠️ Recent errors with details
+
+**JSON Output for Integration:**
+```bash
+node scripts/log-stats.js --json > stats.json
+```
+
+---
+
+## 🧹 Log Management
+
+### Archive and Clear Logs
+
+```bash
+# Archive current logs and start fresh
+npm run logs:clear
+
+# Force delete without archiving
+node scripts/clear-logs.js --force
+```
+
+---
+
+## 💡 Common Use Cases
+
+### 1. **Debug a Failing Order**
+
+```bash
+# Find all errors related to BTC-INR
+node scripts/log-viewer.js --symbol=BTC-INR --errors
+
+# Watch for new orders on BTC-INR
+node scripts/log-viewer.js --symbol=BTC-INR --watch
+```
+
+### 2. **Track Specific Request**
+
+Every request gets a `correlationId`. Use it to track the request through the entire system:
+
+```bash
+# Copy correlation ID from error message, then:
+node scripts/log-viewer.js --correlation=abc123def456
+```
+
+This shows:
+1. MCP request (tool call)
+2. HTTP request (to Zebpay API)
+3. HTTP response (from Zebpay)
+4. MCP response (back to client)
+
+### 3. **Monitor API Performance**
+
+```bash
+# View statistics
+npm run logs:stats
+
+# Watch HTTP requests live
+node scripts/log-viewer.js --type=http_response --watch
+```
+
+### 4. **Debug Authentication Issues**
+
+```bash
+# View all HTTP errors
+node scripts/log-viewer.js --type=http_error
+
+# Filter for authentication-related errors
+node scripts/log-viewer.js --errors | grep -i "auth\|401\|403"
+```
+
+### 5. **Track Specific Tool Usage**
+
+```bash
+# See all calls to a specific tool
+node scripts/log-viewer.js --tool=zebpay_spot_placeMarketOrder
+
+# Watch for new market orders
+node scripts/log-viewer.js --tool=zebpay_spot_placeMarketOrder --watch
+```
+
+---
+
+## 📝 Log Format
+
+All logs are stored as **newline-delimited JSON** in `logs/mcp-server.log`.
+
+### Log Types
+
+#### 1. **HTTP Request**
+```json
+{
+  "level": "info",
+  "type": "http_request",
+  "timestamp": "2024-01-15T10:30:45.123Z",
+  "method": "POST",
+  "url": "https://api.zebpay.com/api/v2/ex/orders",
+  "headers": { "..." },
+  "body": { "symbol": "BTC-INR", "side": "BUY", "..." }
+}
+```
+
+#### 2. **HTTP Response**
+```json
+{
+  "level": "info",
+  "type": "http_response",
+  "timestamp": "2024-01-15T10:30:45.456Z",
+  "method": "POST",
+  "url": "https://api.zebpay.com/api/v2/ex/orders",
+  "status": 200,
+  "durationMs": 333,
+  "body": { "data": { "orderId": "123", "..." } }
+}
+```
+
+#### 3. **MCP Request** (Tool Call)
+```json
+{
+  "level": "info",
+  "type": "mcp_request",
+  "timestamp": "2024-01-15T10:30:45.000Z",
+  "tool": "zebpay_spot_placeMarketOrder",
+  "correlationId": "abc123def456",
+  "params": { "symbol": "BTC-INR", "side": "BUY", "..." }
+}
+```
+
+#### 4. **MCP Response**
+```json
+{
+  "level": "info",
+  "type": "mcp_response",
+  "timestamp": "2024-01-15T10:30:45.500Z",
+  "tool": "zebpay_spot_placeMarketOrder",
+  "correlationId": "abc123def456",
+  "success": true,
+  "durationMs": 500,
+  "result": { "..." }
+}
+```
+
+#### 5. **Errors**
+```json
+{
+  "level": "error",
+  "type": "mcp_error" | "http_error",
+  "timestamp": "2024-01-15T10:30:45.500Z",
+  "error": "Error message",
+  "errorCode": 400,
+  "stack": "...",
+  "..."
+}
+```
+
+---
+
+## 🎨 Color-Coded Output
+
+The log viewer uses colors to make logs easier to read:
+
+- 🟢 **Green**: Success (2xx status codes, INFO level)
+- 🔴 **Red**: Errors (4xx/5xx status codes, ERROR level)
+- 🟡 **Yellow**: Warnings
+- 🔵 **Blue**: Debug information
+- 🟣 **Magenta**: MCP tool calls
+- 🔷 **Cyan**: HTTP requests/responses
+- ⚪ **Gray**: Timestamps and metadata
+
+---
+
+## 🔧 Integration with External Tools
+
+### Export to JSON for Analysis
+
+```bash
+# Export last 100 entries as JSON
+node scripts/log-viewer.js --last=100 --raw > logs/export.json
+
+# Export statistics
+node scripts/log-stats.js --json > logs/stats.json
+```
+
+### Grep/Awk Integration
+
+```bash
+# Find all 500 errors
+node scripts/log-viewer.js --type=http | grep "500"
+
+# Count errors by type
+node scripts/log-viewer.js --errors --raw | jq -r '.type' | sort | uniq -c
+```
+
+### Watch Specific Symbol
+
+```bash
+# Terminal 1: Watch logs
+node scripts/log-viewer.js --symbol=BTC-INR --watch
+
+# Terminal 2: Place orders
+# ... your trading operations ...
+```
+
+---
+
+## 🚨 Troubleshooting
+
+### No logs appearing?
+
+1. **Check if log file exists:**
+   ```bash
+   ls -lh logs/mcp-server.log
+   ```
+
+2. **Make sure server is running with logging enabled:**
+   ```bash
+   npm run start:log-append
+   ```
+
+3. **Check log path in code:**
+   The log path is set in `src/index.ts` where `fileLogger.initialize()` is called.
+
+### Logs too large?
+
+```bash
+# Archive and clear
+npm run logs:clear
+
+# View only recent entries
+node scripts/log-viewer.js --last=100
+```
+
+### Can't find specific request?
+
+Use correlation ID to track requests across the system:
+```bash
+# 1. Find the correlation ID in any log entry
+# 2. Track it through the entire flow:
+node scripts/log-viewer.js --correlation=YOUR_CORRELATION_ID
+```
+
+---
+
+## 📖 Additional Resources
+
+- **Main README**: `../README.md`
+- **Log Source Code**:
+  - HTTP Client: `src/http/httpClient.ts`
+  - MCP Logging: `src/mcp/logging.ts`
+  - File Logger: `src/utils/fileLogger.ts`
+
+---
+
+## 🎯 Best Practices
+
+1. **Always use `--watch` during development** - See issues in real-time
+2. **Use correlation IDs** - Track requests end-to-end
+3. **Archive logs regularly** - Prevent log files from growing too large
+4. **Filter by symbol** - Focus on specific trading pairs
+5. **Check stats dashboard** - Get quick overview of system health
+
+---
+
+## 📞 Need Help?
+
+If you're still having trouble tracking requests/responses:
+
+1. Check the log viewer help: `node scripts/log-viewer.js --help`
+2. Verify logs are being written: `tail -f logs/mcp-server.log`
+3. Check for file permissions issues
+4. Make sure the `logs/` directory exists
+
+Happy tracking! 🎉
+

package/mcp-config.json.example

@@ -0,0 +1,20 @@
+{
+  "mcpServers": {
+    "zebpay": {
+      "command": "node",
+      "args": ["dist/index.js"],
+      "cwd": "/path/to/ai-agents",
+      "env": {
+        "ZEBPAY_API_KEY": "YOUR_API_KEY_HERE",
+        "ZEBPAY_API_SECRET": "YOUR_API_SECRET_HERE",
+        "ZEBPAY_SPOT_BASE_URL": "https://www.zebapi.com/api/v2",
+        "ZEBPAY_FUTURES_BASE_URL": "https://futures-api.zebpay.com/api/v1",
+        "ZEBPAY_MARKET_BASE_URL": "https://www.zebapi.com/api/v1/market",
+        "MCP_TRANSPORTS": "stdio",
+        "LOG_LEVEL": "info",
+        "HTTP_TIMEOUT_MS": "15000",
+        "HTTP_RETRY_COUNT": "2"
+      }
+    }
+  }
+}