@ltorrey/beforethechart-mcp 1.0.0

package/README.md

@@ -0,0 +1,32 @@
+# BeforeTheChart MCP Server
+
+BeforeTheChart MCP provides pre-trade market intelligence tools over the Model Context Protocol (MCP).
+
+## Run
+
+Set the Gumroad license key issued with your purchase, then launch the server:
+
+```bash
+GUMROAD_LICENSE_KEY="YOUR_GUMROAD_LICENSE_KEY" npx -y @ltorrey/beforethechart-mcp
+```
+
+## Claude Desktop
+
+Add this server to the `mcpServers` object in `claude_desktop_config.json`:
+
+```json
+{
+  "BeforeTheChart-MCP": {
+    "command": "npx",
+    "args": ["-y", "@ltorrey/beforethechart-mcp"],
+    "env": {
+      "GUMROAD_LICENSE_KEY": "YOUR_GUMROAD_LICENSE_KEY"
+    }
+  }
+}
+```
+
+## Tools
+
+- `get_market_sentiment` returns recent sentiment data for a stock or cryptocurrency ticker.
+- `calculate_position_size` calculates position sizing from portfolio balance, risk percentage, entry price, and stop loss.

package/dist/auth.js

@@ -0,0 +1,24 @@
+export async function verifyGumroadLicense(licenseKey, productId) {
+    try {
+        const requestBody = new URLSearchParams();
+        requestBody.append("product_id", productId);
+        requestBody.append("license_key", licenseKey);
+        requestBody.append("increment_uses_count", "false"); // Don't burn a use just for booting the server
+        const response = await fetch("https://api.gumroad.com/v2/licenses/verify", {
+            method: "POST",
+            body: requestBody,
+        });
+        const data = await response.json();
+        // Check if valid and not refunded
+        if (data.success &&
+            !data.purchase.refunded &&
+            !data.purchase.chargebacked) {
+            return true;
+        }
+        return false;
+    }
+    catch (error) {
+        console.error("License verification failed.");
+        return false;
+    }
+}

package/dist/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { verifyGumroadLicense } from "./auth.js";
+const GUMROAD_PRODUCT_ID = "wavYh-9BsIk_fYxLpyoh0w==";
+async function main() {
+    const licenseKey = process.env.GUMROAD_LICENSE_KEY;
+    if (!licenseKey) {
+        console.error("Fatal: GUMROAD_LICENSE_KEY environment variable is missing.");
+        process.exit(1);
+    }
+    const isValid = await verifyGumroadLicense(licenseKey, GUMROAD_PRODUCT_ID);
+    if (!isValid) {
+        console.error("Fatal: Invalid or refunded Gumroad License Key.");
+        process.exit(1);
+    }
+    // 1. Initialize Server
+    const server = new McpServer({
+        name: "BeforeTheChart-MCP",
+        version: "1.0.0",
+    });
+    // 2. Register Tool: Sentiment Aggregator
+    server.tool("get_market_sentiment", "Fetches recent news sentiment for a specific ticker symbol", {
+        ticker: z
+            .string()
+            .describe("The stock or crypto ticker symbol (e.g. AAPL, BTC)"),
+    }, async ({ ticker }) => {
+        // Stub: Wire to Finnhub or X API in production
+        const mockSentiment = {
+            asset: ticker,
+            bullish_signals: 14,
+            bearish_signals: 2,
+            trend: "Strong Buy",
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(mockSentiment, null, 2),
+                },
+            ],
+        };
+    });
+    // 3. Register Tool: Risk Sandbox
+    server.tool("calculate_position_size", "Calculates optimal position sizing based on portfolio risk tolerance", {
+        portfolio_balance: z.number(),
+        risk_percentage: z.number().max(10),
+        entry_price: z.number(),
+        stop_loss: z.number(),
+    }, async ({ portfolio_balance, risk_percentage, entry_price, stop_loss }) => {
+        const riskAmount = portfolio_balance * (risk_percentage / 100);
+        const priceRisk = Math.abs(entry_price - stop_loss);
+        const positionSize = riskAmount / priceRisk;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Suggested Position Size: ${positionSize.toFixed(4)} units. Total Capital at Risk: $${riskAmount.toFixed(2)}`,
+                },
+            ],
+        };
+    });
+    // 4. Connect Transport Layer
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("BeforeTheChart MCP Server running safely on stdio.");
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@ltorrey/beforethechart-mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "bin": {
+    "pretrade-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.2",
+    "tsx": "^4.23.13",
+    "typescript": "^7.0.2"
+  }
+}

package/smithery.yaml

@@ -0,0 +1,18 @@
+startCommand:
+  type: stdio
+  configSchema:
+    type: object
+    required:
+      - gumroadLicenseKey
+    properties:
+      gumroadLicenseKey:
+        type: string
+        description: Your BeforeTheChart Gumroad license key.
+  commandFunction: |-
+    (config) => ({
+      command: 'npx',
+      args: ['-y', '@ltorrey/beforethechart-mcp'],
+      env: { GUMROAD_LICENSE_KEY: config.gumroadLicenseKey }
+    })
+  exampleConfig:
+    gumroadLicenseKey: YOUR_GUMROAD_LICENSE_KEY

package/src/auth.ts

@@ -0,0 +1,32 @@
+export async function verifyGumroadLicense(
+  licenseKey: string,
+  productId: string,
+): Promise<boolean> {
+  try {
+    const requestBody = new URLSearchParams();
+    requestBody.append("product_id", productId);
+    requestBody.append("license_key", licenseKey);
+    requestBody.append("increment_uses_count", "false"); // Don't burn a use just for booting the server
+
+    const response = await fetch("https://api.gumroad.com/v2/licenses/verify", {
+      method: "POST",
+      body: requestBody,
+    });
+
+    const data = await response.json();
+
+    // Check if valid and not refunded
+    if (
+      data.success &&
+      !data.purchase.refunded &&
+      !data.purchase.chargebacked
+    ) {
+      return true;
+    }
+
+    return false;
+  } catch (error) {
+    console.error("License verification failed.");
+    return false;
+  }
+}

package/src/index.ts

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+import { verifyGumroadLicense } from "./auth.js";
+
+const GUMROAD_PRODUCT_ID = "wavYh-9BsIk_fYxLpyoh0w==";
+
+async function main() {
+  const licenseKey = process.env.GUMROAD_LICENSE_KEY;
+
+  if (!licenseKey) {
+    console.error(
+      "Fatal: GUMROAD_LICENSE_KEY environment variable is missing.",
+    );
+    process.exit(1);
+  }
+
+  const isValid = await verifyGumroadLicense(licenseKey, GUMROAD_PRODUCT_ID);
+  if (!isValid) {
+    console.error("Fatal: Invalid or refunded Gumroad License Key.");
+    process.exit(1);
+  }
+
+  // 1. Initialize Server
+  const server = new McpServer({
+    name: "BeforeTheChart-MCP",
+    version: "1.0.0",
+  });
+
+  // 2. Register Tool: Sentiment Aggregator
+  server.tool(
+    "get_market_sentiment",
+    "Fetches recent news sentiment for a specific ticker symbol",
+    {
+      ticker: z
+        .string()
+        .describe("The stock or crypto ticker symbol (e.g. AAPL, BTC)"),
+    },
+    async ({ ticker }) => {
+      // Stub: Wire to Finnhub or X API in production
+      const mockSentiment = {
+        asset: ticker,
+        bullish_signals: 14,
+        bearish_signals: 2,
+        trend: "Strong Buy",
+      };
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(mockSentiment, null, 2),
+          },
+        ],
+      };
+    },
+  );
+
+  // 3. Register Tool: Risk Sandbox
+  server.tool(
+    "calculate_position_size",
+    "Calculates optimal position sizing based on portfolio risk tolerance",
+    {
+      portfolio_balance: z.number(),
+      risk_percentage: z.number().max(10),
+      entry_price: z.number(),
+      stop_loss: z.number(),
+    },
+    async ({ portfolio_balance, risk_percentage, entry_price, stop_loss }) => {
+      const riskAmount = portfolio_balance * (risk_percentage / 100);
+      const priceRisk = Math.abs(entry_price - stop_loss);
+      const positionSize = riskAmount / priceRisk;
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Suggested Position Size: ${positionSize.toFixed(4)} units. Total Capital at Risk: $${riskAmount.toFixed(2)}`,
+          },
+        ],
+      };
+    },
+  );
+
+  // 4. Connect Transport Layer
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("BeforeTheChart MCP Server running safely on stdio.");
+}
+
+main().catch(console.error);

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "rootDir": "src",
+    "outDir": "dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}