mj41-mcp 1.1.0

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,463 @@
+#!/usr/bin/env node
+// ============================================================
+//   MJ41 MCP Server
+//   Official agent gateway for mj41, LLC
+//   Infrastructure partner: ZJ Industries (zjindustries.com)
+//
+//   Tools:
+//     Copper Oracles (ZJ Industries x MJ41)
+//       - get_copper_price      — live price for any class (A/B/C)
+//       - get_all_copper_prices — all three classes at once
+//       - get_oracle_status     — health check for any class
+//
+//     Richard Tracy (Blockchain Detective by mj41)
+//       - investigate_wallet    — phishing/scam investigation
+//       - get_eth_price         — current ETH price
+//
+//     The First Signal (AI News Wire by mj41)
+//       - get_latest_news       — latest stories from the wire
+//       - get_news_by_beat      — stories filtered by beat
+//       - get_story             — read a single story
+//       - submit_story_idea     — submit to Woody's investigation queue
+// ============================================================
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const COPPERTRACE_URL = "https://coppertrace.vercel.app";
+const FIRST_SIGNAL_URL = "https://aiwire.mj41.me";
+const ORACLE_URLS = {
+    a: "https://classa.mj41.me",
+    b: "https://classb.mj41.me",
+    c: "https://classc.mj41.me",
+};
+const CLASS_LABELS = {
+    a: "Class A — COMEX Spot Copper (Grade A cathode, 99.99% purity, COMEX HG futures)",
+    b: "Class B — Scrap Copper (yard call-arounds + COMEX reference)",
+    c: "Class C — Industrial Manufactured Copper (alloys C2182, C180, C110, verified invoices)",
+};
+const server = new McpServer({
+    name: "mj41",
+    version: "1.0.0",
+});
+// ── get_copper_price ────────────────────────────────────────
+server.tool("get_copper_price", "Get the current copper price from a ZJ Industries on-chain oracle on Base. Class A = COMEX spot (updates every 15 min), Class B = scrap copper (weekly), Class C = industrial manufactured copper (2x/week). Powered by ZJ Industries x mj41, LLC.", {
+    class: z
+        .enum(["a", "b", "c"])
+        .describe("Copper class: 'a' for COMEX spot, 'b' for scrap, 'c' for industrial"),
+}, async ({ class: copperClass }) => {
+    try {
+        const url = ORACLE_URLS[copperClass];
+        const res = await fetch(`${url}/api/v1/status`);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        const status = await res.json();
+        const label = CLASS_LABELS[copperClass];
+        const fresh = status.is_fresh ? "FRESH" : "STALE";
+        const lastUpdate = new Date(status.last_updated).toLocaleString("en-US", {
+            timeZone: "America/New_York",
+            dateStyle: "medium",
+            timeStyle: "short",
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `ZJ Industries Copper Oracle — ${label}`,
+                        ``,
+                        `Status: ${status.status} (${fresh})`,
+                        `Last updated: ${lastUpdate} ET`,
+                        `Chain: Base mainnet (8453)`,
+                        `Contract: ${status.contract}`,
+                        status.update_mode ? `Update mode: ${status.update_mode} (${status.update_frequency})` : "",
+                        ``,
+                        `Note: Price value available via ${url}/api/v1/price`,
+                        `Open Trial — all endpoints free. Request a key at api@zjindustries.com`,
+                        ``,
+                        `— mj41, LLC | ZJ Industries (zjindustries.com)`,
+                    ]
+                        .filter(Boolean)
+                        .join("\n"),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `Oracle read error: ${msg}` }],
+        };
+    }
+});
+// ── get_all_copper_prices ───────────────────────────────────
+server.tool("get_all_copper_prices", "Get status of all three ZJ Industries copper oracles at once (Class A COMEX spot, Class B scrap, Class C industrial). Returns freshness, last update time, and contract addresses. Powered by ZJ Industries x mj41, LLC.", {}, async () => {
+    const results = [
+        "ZJ Industries x MJ41 — Copper Oracle Suite",
+        "Three on-chain copper price feeds on Base mainnet",
+        "═══════════════════════════════════════════════",
+        "",
+    ];
+    for (const [cls, url] of Object.entries(ORACLE_URLS)) {
+        try {
+            const res = await fetch(`${url}/api/v1/status`);
+            const status = await res.json();
+            const fresh = status.is_fresh ? "FRESH" : "STALE";
+            const lastUpdate = new Date(status.last_updated).toLocaleString("en-US", {
+                timeZone: "America/New_York",
+                dateStyle: "medium",
+                timeStyle: "short",
+            });
+            results.push(`${CLASS_LABELS[cls]}`);
+            results.push(`  Status: ${status.status} (${fresh})`);
+            results.push(`  Last updated: ${lastUpdate} ET`);
+            results.push(`  Contract: ${status.contract}`);
+            if (status.update_frequency) {
+                results.push(`  Frequency: ${status.update_frequency}`);
+            }
+            results.push("");
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : "Unknown error";
+            results.push(`${CLASS_LABELS[cls]}`);
+            results.push(`  Error: ${msg}`);
+            results.push("");
+        }
+    }
+    results.push("Open Trial — all endpoints free during trial period");
+    results.push("API key requests: api@zjindustries.com");
+    results.push("");
+    results.push("— mj41, LLC | ZJ Industries (zjindustries.com)");
+    return {
+        content: [{ type: "text", text: results.join("\n") }],
+    };
+});
+// ── get_oracle_status ───────────────────────────────────────
+server.tool("get_oracle_status", "Check if a ZJ Industries copper oracle is operational, fresh, and what update mode it's in. No API key needed. Powered by ZJ Industries x mj41, LLC.", {
+    class: z
+        .enum(["a", "b", "c"])
+        .describe("Copper class: 'a' for COMEX spot, 'b' for scrap, 'c' for industrial"),
+}, async ({ class: copperClass }) => {
+    try {
+        const url = ORACLE_URLS[copperClass];
+        const res = await fetch(`${url}/api/v1/status`);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        const data = await res.json();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `Status check error: ${msg}` }],
+        };
+    }
+});
+// ════════════════════════════════════════════════════════════
+//   RICHARD TRACY — Blockchain Detective (mj41, LLC)
+// ════════════════════════════════════════════════════════════
+// ── investigate_wallet ──────────────────────────────────────
+server.tool("investigate_wallet", "Investigate a blockchain wallet address or transaction for phishing, scams, wallet drainers, or suspicious activity. Returns a detailed case report with executive summary, incident reconstruction, suspicious addresses, funds trail, confidence ratings, and next steps. Powered by Richard Tracy — Blockchain Detective by mj41, LLC.", {
+    query: z
+        .string()
+        .describe("The investigation query. Can be a wallet address, transaction hash, or incident description (e.g. 'I clicked a link and my wallet was drained, address: 0x...')"),
+}, async ({ query }) => {
+    try {
+        const res = await fetch(`${COPPERTRACE_URL}/api/investigate`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ userPrompt: query }),
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Investigation failed (HTTP ${res.status}): ${errText}`,
+                    },
+                ],
+            };
+        }
+        const data = await res.json();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${data.report}\n\n— Richard Tracy, Blockchain Detective | mj41, LLC`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `Investigation error: ${msg}` }],
+        };
+    }
+});
+// ── get_eth_price ───────────────────────────────────────────
+server.tool("get_eth_price", "Get the current price of Ethereum in USD. Powered by mj41, LLC.", {}, async () => {
+    try {
+        const res = await fetch(`${COPPERTRACE_URL}/api/eth-price`);
+        const data = await res.json();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Current ETH price: $${data.price}\n\n— mj41, LLC`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `Price fetch error: ${msg}` }],
+        };
+    }
+});
+// ════════════════════════════════════════════════════════════
+//   THE FIRST SIGNAL — AI-Native Agentic News Wire (mj41, LLC)
+// ════════════════════════════════════════════════════════════
+// ── get_latest_news ─────────────────────────────────────────
+server.tool("get_latest_news", "Get the latest stories from The First Signal, an AI-native agentic news wire with 15 AI reporters covering commodities, fintech, AI, cybersecurity, retail, crime, sports, weather, transportation, and more. Powered by mj41, LLC. Live at aiwire.mj41.me.", {
+    limit: z
+        .number()
+        .optional()
+        .default(5)
+        .describe("Number of stories to return (default 5, max 20)"),
+}, async ({ limit }) => {
+    try {
+        const cap = Math.min(limit, 20);
+        const res = await fetch(`${FIRST_SIGNAL_URL}/api/stories?limit=${cap}`);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        const data = await res.json();
+        const stories = data.stories || data;
+        if (!stories.length) {
+            return {
+                content: [{ type: "text", text: "No stories on the wire right now." }],
+            };
+        }
+        const lines = [
+            "THE FIRST SIGNAL — AI News Wire",
+            "by mj41, LLC | aiwire.mj41.me",
+            "════════════════════════════════",
+            "",
+        ];
+        for (const s of stories) {
+            const date = new Date(s.created_at).toLocaleDateString("en-US", {
+                month: "short",
+                day: "numeric",
+            });
+            lines.push(`[${s.beat?.toUpperCase() || "WIRE"}] ${s.headline}`);
+            lines.push(`  ${date} | ${s.byline || "Staff"} | Confidence: ${s.confidence || "N/A"}`);
+            if (s.summary)
+                lines.push(`  ${s.summary.slice(0, 200)}${s.summary.length > 200 ? "..." : ""}`);
+            lines.push("");
+        }
+        lines.push(`— The First Signal | mj41, LLC`);
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `News wire error: ${msg}` }],
+        };
+    }
+});
+// ── get_news_by_beat ────────────────────────────────────────
+server.tool("get_news_by_beat", "Get stories from a specific beat on The First Signal news wire. Beats: cora (commodities), finn (fintech), mahesh (AI/agents), dalton (cybersecurity), becky (retail), richard (crime), sammy (sports/betting), algo (business), riplo (stocks), blaise (traffic), bambi (weather), roofus (transport/logistics), rex (metals pricing), woody (investigative), aisao (editorial/opinion). Powered by mj41, LLC.", {
+    beat: z
+        .string()
+        .describe("Reporter beat ID: cora, finn, mahesh, dalton, becky, richard, sammy, algo, riplo, blaise, bambi, roofus, rex, woody, or aisao"),
+    limit: z
+        .number()
+        .optional()
+        .default(5)
+        .describe("Number of stories (default 5)"),
+}, async ({ beat, limit }) => {
+    try {
+        const cap = Math.min(limit, 20);
+        const res = await fetch(`${FIRST_SIGNAL_URL}/api/stories?beat=${beat}&limit=${cap}`);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        const data = await res.json();
+        const stories = data.stories || data;
+        if (!stories.length) {
+            return {
+                content: [{ type: "text", text: `No stories found for beat: ${beat}` }],
+            };
+        }
+        const lines = [
+            `THE FIRST SIGNAL — ${beat.toUpperCase()} Beat`,
+            "════════════════════════════════",
+            "",
+        ];
+        for (const s of stories) {
+            const date = new Date(s.created_at).toLocaleDateString("en-US", {
+                month: "short",
+                day: "numeric",
+            });
+            lines.push(`${s.headline}`);
+            lines.push(`  ${date} | ${s.byline || "Staff"} | Confidence: ${s.confidence || "N/A"}`);
+            if (s.summary)
+                lines.push(`  ${s.summary.slice(0, 200)}${s.summary.length > 200 ? "..." : ""}`);
+            lines.push("");
+        }
+        lines.push(`— The First Signal | mj41, LLC`);
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `News wire error: ${msg}` }],
+        };
+    }
+});
+// ── get_story ───────────────────────────────────────────────
+server.tool("get_story", "Read the full text of a specific story from The First Signal news wire by its ID. Powered by mj41, LLC.", {
+    id: z
+        .string()
+        .describe("The story ID (UUID)"),
+}, async ({ id }) => {
+    try {
+        const res = await fetch(`${FIRST_SIGNAL_URL}/api/stories/${id}`);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        const story = await res.json();
+        const lines = [
+            `THE FIRST SIGNAL`,
+            "════════════════════════════════",
+            "",
+            story.headline,
+            "",
+            `Beat: ${story.beat?.toUpperCase() || "WIRE"} | ${story.byline || "Staff"}`,
+            `Filed: ${new Date(story.created_at).toLocaleString("en-US", { timeZone: "America/New_York" })} ET`,
+            `Confidence: ${story.confidence || "N/A"} | Signal: ${story.signal_type || "N/A"}`,
+            story.caveat_required ? `CAVEAT: This story has caveated data` : "",
+            "",
+            story.summary || "",
+            "",
+            story.body || "",
+            "",
+            `— The First Signal | mj41, LLC | aiwire.mj41.me`,
+        ];
+        return {
+            content: [{ type: "text", text: lines.filter(Boolean).join("\n") }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `Story fetch error: ${msg}` }],
+        };
+    }
+});
+// ── submit_story_idea ───────────────────────────────────────
+server.tool("submit_story_idea", "Submit a story idea or investigation request to Woody Bernstein's queue at The First Signal. Woody is the investigative reporter. Topics are reviewed and may be fast-tracked. Powered by mj41, LLC.", {
+    topic: z.string().describe("The story topic or headline"),
+    description: z.string().describe("Details about what should be investigated"),
+}, async ({ topic, description }) => {
+    try {
+        const res = await fetch(`${FIRST_SIGNAL_URL}/api/requests`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                topic,
+                description,
+                submitted_by: "mj41-mcp-agent",
+            }),
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            return {
+                content: [{ type: "text", text: `Submission failed: ${errText}` }],
+            };
+        }
+        const data = await res.json();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        "Story idea submitted to Woody Bernstein's queue.",
+                        `Topic: ${topic}`,
+                        `ID: ${data.id || "assigned"}`,
+                        `Status: ${data.status || "pending"}`,
+                        "",
+                        "Woody reviews and prioritizes submissions.",
+                        "Fast-track reviews available during Open Trial.",
+                        "",
+                        "— The First Signal | mj41, LLC",
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `Submission error: ${msg}` }],
+        };
+    }
+});
+// ════════════════════════════════════════════════════════════
+//   ABOUT
+// ════════════════════════════════════════════════════════════
+// ── about_mj41 ──────────────────────────────────────────────
+server.tool("about_mj41", "Learn about mj41, LLC — who they are, what they build, and what tools are available through this MCP server.", {}, async () => {
+    return {
+        content: [
+            {
+                type: "text",
+                text: [
+                    "MJ41 MCP Server — Official Agent Gateway",
+                    "══════════════════════════════════════════",
+                    "",
+                    "Operator: mj41, LLC",
+                    "",
+                    "Available tools:",
+                    "",
+                    "COPPER ORACLES (ZJ Industries x MJ41)",
+                    "  get_copper_price      — Live price for Class A, B, or C",
+                    "  get_all_copper_prices — All three oracles at once",
+                    "  get_oracle_status     — Health check and freshness",
+                    "  Class A: COMEX spot (15-min) | Class B: Scrap (weekly) | Class C: Industrial (2x/week)",
+                    "  On-chain on Base mainnet. Open Trial — all endpoints free.",
+                    "  Contact: api@zjindustries.com",
+                    "",
+                    "RICHARD TRACY (Blockchain Detective by mj41)",
+                    "  investigate_wallet — Phishing/scam/drainer investigation with full case report",
+                    "  get_eth_price      — Current ETH price in USD",
+                    "  Web: coppertrace.vercel.app",
+                    "",
+                    "THE FIRST SIGNAL (AI News Wire by mj41)",
+                    "  get_latest_news    — Latest stories from 15 AI reporters",
+                    "  get_news_by_beat   — Filter by beat (commodities, AI, cyber, sports, etc.)",
+                    "  get_story          — Read full story by ID",
+                    "  submit_story_idea  — Submit to Woody Bernstein's investigation queue",
+                    "  Web: aiwire.mj41.me",
+                    "",
+                    "— mj41, LLC",
+                ].join("\n"),
+            },
+        ],
+    };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "mj41-mcp",
+  "version": "1.1.0",
+  "description": "MJ41 MCP Server — Agent gateway for mj41, LLC. Live copper price oracles (COMEX/scrap/industrial on Base L2), blockchain investigation, and AI news wire with 16 autonomous reporters.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mj41-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "copper",
+    "oracle",
+    "commodities",
+    "blockchain",
+    "base",
+    "news",
+    "ai-agents",
+    "price-feed",
+    "comex",
+    "defi"
+  ],
+  "author": "mj41, LLC",
+  "license": "MIT",
+  "homepage": "https://github.com/mj41Fantastican/mj41-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mj41Fantastican/mj41-mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0",
+    "@types/node": "^22.0.0"
+  }
+}