mj41-mcp 1.3.0 → 1.5.0

package/dist/index.js

@@ -10,6 +10,10 @@
 //       - get_all_copper_prices — all three classes at once
 //       - get_oracle_status     — health check for any class
 //
+//     Metals Oracles (ZJ Industries x MJ41)
+//       - get_metal_price       — live price for gold, silver, aluminum, platinum, or palladium
+//       - get_all_metal_prices  — all 8 oracles (3 copper + 5 metals) at once
+//
 //     Richard Tracy (Blockchain Detective by mj41)
 //       - investigate_wallet    — phishing/scam investigation
 //       - get_eth_price         — current ETH price
@@ -73,13 +77,66 @@ function copperHolidayNote() {
     }
     return "Copper Holiday has ended. API key required. Register with the register tool.";
 }
+const BILLING_URL = "https://rwacu.com/api/billing";
 const COPPERTRACE_URL = "https://coppertrace.vercel.app";
 const FIRST_SIGNAL_URL = "https://aiwire.mj41.me";
+// ── Billing gate ─────────────────────────────────────────────
+// During Copper Holiday: all calls free, no key needed.
+// After June 28: key required, balance deducted per call.
+let storedApiKey = null;
+async function billingGate(tool) {
+    if (isCopperHoliday()) {
+        return { allowed: true, message: copperHolidayNote() };
+    }
+    if (!storedApiKey) {
+        return {
+            allowed: false,
+            message: "API key required. Use the register tool to create one, then set_api_key to activate it.",
+        };
+    }
+    try {
+        const res = await fetch(`${BILLING_URL}/use`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ key: storedApiKey, tool }),
+        });
+        const data = await res.json();
+        if (!data.allowed) {
+            return {
+                allowed: false,
+                message: data.reason || "No calls remaining. Use buy_calls to purchase more.",
+            };
+        }
+        return {
+            allowed: true,
+            message: data.balance >= 0 ? `${data.balance} calls remaining` : "",
+        };
+    }
+    catch {
+        // If billing API is down, allow the call (fail open during transition)
+        return { allowed: true, message: "Billing check unavailable — call allowed" };
+    }
+}
 const ORACLE_URLS = {
     a: "https://classa.mj41.me",
     b: "https://classb.mj41.me",
     c: "https://classc.mj41.me",
 };
+const METALS_BASE = "https://metals.mj41.me";
+const METAL_URLS = {
+    gold: METALS_BASE,
+    silver: METALS_BASE,
+    aluminum: METALS_BASE,
+    platinum: METALS_BASE,
+    palladium: METALS_BASE,
+};
+const METAL_LABELS = {
+    gold: "Gold — COMEX GC=F (USD/troy oz)",
+    silver: "Silver — COMEX SI=F (USD/troy oz)",
+    aluminum: "Aluminum — COMEX ALI=F (USD/lb)",
+    platinum: "Platinum — NYMEX PL=F (USD/troy oz)",
+    palladium: "Palladium — NYMEX PA=F (USD/troy oz)",
+};
 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)",
@@ -95,6 +152,9 @@ server.tool("get_copper_price", "Get the current copper price from a ZJ Industri
         .enum(["a", "b", "c"])
         .describe("Copper class: 'a' for COMEX spot, 'b' for scrap, 'c' for industrial"),
 }, async ({ class: copperClass }) => {
+    const gate = await billingGate("get_copper_price");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
     try {
         checkRate("copper", RATE.COPPER);
         const url = ORACLE_URLS[copperClass];
@@ -125,7 +185,7 @@ server.tool("get_copper_price", "Get the current copper price from a ZJ Industri
                         status.update_mode ? `Update mode: ${status.update_mode} (${status.update_frequency})` : "",
                         ``,
                         `Note: Price value available via ${url}/api/v1/price`,
-                        copperHolidayNote(),
+                        gate.message,
                         ``,
                         `— mj41, LLC | ZJ Industries (zjindustries.com)`,
                     ]
@@ -144,6 +204,9 @@ server.tool("get_copper_price", "Get the current copper price from a ZJ Industri
 });
 // ── 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 gate = await billingGate("get_all_copper_prices");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
     const results = [
         "ZJ Industries x MJ41 — Copper Oracle Suite",
         "Three on-chain copper price feeds on Base mainnet",
@@ -192,6 +255,9 @@ server.tool("get_oracle_status", "Check if a ZJ Industries copper oracle is oper
         .enum(["a", "b", "c"])
         .describe("Copper class: 'a' for COMEX spot, 'b' for scrap, 'c' for industrial"),
 }, async ({ class: copperClass }) => {
+    const gate = await billingGate("get_oracle_status");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
     try {
         checkRate("copper", RATE.COPPER);
         const url = ORACLE_URLS[copperClass];
@@ -218,6 +284,141 @@ server.tool("get_oracle_status", "Check if a ZJ Industries copper oracle is oper
     }
 });
 // ════════════════════════════════════════════════════════════
+//   METALS ORACLES — ZJ Industries x MJ41
+// ════════════════════════════════════════════════════════════
+// ── get_metal_price ─────────────────────────────────────────
+server.tool("get_metal_price", "Get the current price of a precious or industrial metal from a ZJ Industries on-chain oracle on Base. Available metals: gold (COMEX GC=F), silver (COMEX SI=F), aluminum (COMEX ALI=F), platinum (NYMEX PL=F), palladium (NYMEX PA=F). All prices update every 15 minutes during market hours. Powered by ZJ Industries x mj41, LLC.", {
+    metal: z
+        .enum(["gold", "silver", "aluminum", "platinum", "palladium"])
+        .describe("Metal to query: gold, silver, aluminum, platinum, or palladium"),
+}, async ({ metal }) => {
+    const gate = await billingGate("get_metal_price");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
+    try {
+        checkRate("copper", RATE.COPPER);
+        const status = await cachedFetch(`metal-status-${metal}`, async () => {
+            const res = await fetch(`${METALS_BASE}/api/v1/${metal}/status`);
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status}`);
+            return res.json();
+        }, TTL.COPPER_STATUS);
+        const label = METAL_LABELS[metal];
+        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 Metal Oracle — ${label}`,
+                        ``,
+                        status.price ? `Price: $${status.price} ${status.unit}` : "",
+                        `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})` : "",
+                        ``,
+                        gate.message,
+                        ``,
+                        `— 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_metal_prices ────────────────────────────────────
+server.tool("get_all_metal_prices", "Get status of all 8 ZJ Industries on-chain oracles at once — 3 copper classes (A COMEX spot, B scrap, C industrial) plus 5 metals (gold, silver, aluminum, platinum, palladium). Returns freshness, last update time, and contract addresses for each. Powered by ZJ Industries x mj41, LLC.", {}, async () => {
+    const gate = await billingGate("get_all_metal_prices");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
+    const results = [
+        "ZJ Industries x MJ41 — Full Metals Oracle Suite",
+        "8 on-chain price feeds on Base mainnet",
+        "═══════════════════════════════════════════════",
+        "",
+        "COPPER ORACLES",
+        "──────────────",
+        "",
+    ];
+    checkRate("copper", RATE.COPPER);
+    // Copper oracles
+    for (const [cls, url] of Object.entries(ORACLE_URLS)) {
+        try {
+            const status = await cachedFetch(`copper-status-${cls}`, async () => {
+                const res = await fetch(`${url}/api/v1/status`);
+                return res.json();
+            }, TTL.COPPER_STATUS);
+            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}`);
+            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("METALS ORACLES");
+    results.push("──────────────");
+    results.push("");
+    // Metal oracles
+    for (const metal of Object.keys(METAL_URLS)) {
+        try {
+            const status = await cachedFetch(`metal-status-${metal}`, async () => {
+                const res = await fetch(`${METALS_BASE}/api/v1/${metal}/status`);
+                return res.json();
+            }, TTL.COPPER_STATUS);
+            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(`${METAL_LABELS[metal]}`);
+            results.push(`  Status: ${status.status} (${fresh})`);
+            results.push(`  Last updated: ${lastUpdate} ET`);
+            results.push(`  Contract: ${status.contract}`);
+            results.push("");
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : "Unknown error";
+            results.push(`${METAL_LABELS[metal]}`);
+            results.push(`  Error: ${msg}`);
+            results.push("");
+        }
+    }
+    results.push(copperHolidayNote());
+    results.push("");
+    results.push("— mj41, LLC | ZJ Industries (zjindustries.com)");
+    return {
+        content: [{ type: "text", text: results.join("\n") }],
+    };
+});
+// ════════════════════════════════════════════════════════════
 //   RICHARD TRACY — Blockchain Detective (mj41, LLC)
 // ════════════════════════════════════════════════════════════
 // ── investigate_wallet ──────────────────────────────────────
@@ -226,6 +427,9 @@ server.tool("investigate_wallet", "Investigate a blockchain wallet address or tr
         .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 }) => {
+    const gate = await billingGate("investigate_wallet");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
     try {
         checkRate("richard", RATE.RICHARD);
         // No cache — investigations are unique per query
@@ -264,6 +468,9 @@ server.tool("investigate_wallet", "Investigate a blockchain wallet address or tr
 });
 // ── get_eth_price ───────────────────────────────────────────
 server.tool("get_eth_price", "Get the current price of Ethereum in USD. Powered by mj41, LLC.", {}, async () => {
+    const gate = await billingGate("get_eth_price");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
     try {
         checkRate("richard", RATE.RICHARD);
         const data = await cachedFetch("eth-price", async () => {
@@ -297,6 +504,9 @@ server.tool("get_latest_news", "Get the latest stories from The First Signal, an
         .default(5)
         .describe("Number of stories to return (default 5, max 20)"),
 }, async ({ limit }) => {
+    const gate = await billingGate("get_latest_news");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
     try {
         checkRate("first-signal", RATE.FIRST_SIGNAL);
         const cap = Math.min(limit, 20);
@@ -354,6 +564,9 @@ server.tool("get_news_by_beat", "Get stories from a specific beat on The First S
         .default(5)
         .describe("Number of stories (default 5)"),
 }, async ({ beat, limit }) => {
+    const gate = await billingGate("get_news_by_beat");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
     try {
         checkRate("first-signal", RATE.FIRST_SIGNAL);
         const cap = Math.min(limit, 20);
@@ -405,6 +618,9 @@ server.tool("get_story", "Read the full text of a specific story from The First
         .string()
         .describe("The story ID (UUID)"),
 }, async ({ id }) => {
+    const gate = await billingGate("get_story");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
     try {
         checkRate("first-signal", RATE.FIRST_SIGNAL);
         const story = await cachedFetch(`news-story-${id}`, async () => {
@@ -446,6 +662,9 @@ server.tool("submit_story_idea", "Submit a story idea or investigation request t
     topic: z.string().describe("The story topic or headline"),
     description: z.string().describe("Details about what should be investigated"),
 }, async ({ topic, description }) => {
+    const gate = await billingGate("submit_story_idea");
+    if (!gate.allowed)
+        return { content: [{ type: "text", text: gate.message }] };
     try {
         checkRate("first-signal", RATE.FIRST_SIGNAL);
         // No cache — write operation
@@ -492,6 +711,177 @@ server.tool("submit_story_idea", "Submit a story idea or investigation request t
     }
 });
 // ════════════════════════════════════════════════════════════
+//   BILLING — Register, Set Key, Buy Calls, Check Balance
+// ════════════════════════════════════════════════════════════
+// ── register ────────────────────────────────────────────────
+server.tool("register", "Register for an mj41 MCP API key. Returns a key with 10 free calls. Save the key — it cannot be recovered. After the Copper Holiday (June 28, 2026), an API key is required for all tool calls.", {
+    label: z
+        .string()
+        .optional()
+        .describe("Optional label for this key (e.g. your name or bot name)"),
+}, async ({ label }) => {
+    try {
+        const res = await fetch(`${BILLING_URL}/register`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ label: label || "" }),
+        });
+        const data = await res.json();
+        if (data.error) {
+            return { content: [{ type: "text", text: `Registration failed: ${data.error}` }] };
+        }
+        // Auto-store the key for this session
+        storedApiKey = data.key;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        "MJ41 API KEY REGISTERED",
+                        "═══════════════════════",
+                        "",
+                        `Key: ${data.key}`,
+                        `Balance: ${data.balance} free calls`,
+                        "",
+                        "SAVE THIS KEY — it cannot be recovered.",
+                        "Key has been activated for this session.",
+                        "",
+                        "Pricing (after Copper Holiday ends June 28):",
+                        "  41 RWACu / call — pay with RWACu, save 50%",
+                        "  82 RWACu equiv / call — pay with USDC or Stripe",
+                        "",
+                        "Use buy_calls to purchase more when your balance runs low.",
+                        "",
+                        copperHolidayNote(),
+                        "",
+                        "— mj41, LLC",
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return { content: [{ type: "text", text: `Registration error: ${msg}` }] };
+    }
+});
+// ── set_api_key ─────────────────────────────────────────────
+server.tool("set_api_key", "Set your mj41 API key for this session. Required after the Copper Holiday ends (June 28, 2026). If you already have a key, use this to activate it.", {
+    key: z.string().describe("Your mj41 API key (starts with mj41_)"),
+}, async ({ key }) => {
+    try {
+        const res = await fetch(`${BILLING_URL}/balance?key=${encodeURIComponent(key)}`);
+        const data = await res.json();
+        if (data.error) {
+            return { content: [{ type: "text", text: `Invalid key: ${data.error}` }] };
+        }
+        storedApiKey = key;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        "API key activated for this session.",
+                        "",
+                        `Balance: ${data.balance} calls remaining`,
+                        `Total used: ${data.total_used}`,
+                        `Total purchased: ${data.total_purchased}`,
+                        "",
+                        copperHolidayNote(),
+                        "",
+                        "— mj41, LLC",
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return { content: [{ type: "text", text: `Key validation error: ${msg}` }] };
+    }
+});
+// ── check_balance ───────────────────────────────────────────
+server.tool("check_balance", "Check your remaining call balance on the mj41 MCP server.", {}, async () => {
+    if (!storedApiKey) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: isCopperHoliday()
+                        ? `No API key set — but all calls are free during the Copper Holiday.\n\n${copperHolidayNote()}`
+                        : "No API key set. Use register to create one or set_api_key to activate an existing key.",
+                },
+            ],
+        };
+    }
+    try {
+        const res = await fetch(`${BILLING_URL}/balance?key=${encodeURIComponent(storedApiKey)}`);
+        const data = await res.json();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        "MJ41 ACCOUNT",
+                        "═════════════",
+                        "",
+                        `Balance: ${data.balance} calls remaining`,
+                        `Total used: ${data.total_used}`,
+                        `Total purchased: ${data.total_purchased}`,
+                        data.copper_holiday ? "Status: COPPER HOLIDAY — all calls free until June 28" : "",
+                        "",
+                        copperHolidayNote(),
+                        "",
+                        "— mj41, LLC",
+                    ]
+                        .filter(Boolean)
+                        .join("\n"),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        return { content: [{ type: "text", text: `Balance check error: ${msg}` }] };
+    }
+});
+// ── buy_calls ───────────────────────────────────────────────
+server.tool("buy_calls", "Get payment instructions to purchase more MCP tool calls. Pay with RWACu (save 50%), USDC, or Stripe.", {}, async () => {
+    return {
+        content: [
+            {
+                type: "text",
+                text: [
+                    "BUY MJ41 MCP CALLS",
+                    "═══════════════════",
+                    "",
+                    "OPTION 1: RWACu (save 50%)",
+                    "  Rate: 41 RWACu per call",
+                    "  Send RWACu to: 0x758AF4a670adE40C2FfE1B6C4746340910a44B96",
+                    "  Network: Base (Chain ID 8453)",
+                    "  Include your API key in the transaction memo or email it after sending.",
+                    "",
+                    "OPTION 2: USDC",
+                    "  Rate: 82 RWACu equivalent in USDC per call",
+                    "  Send USDC to: 0x758AF4a670adE40C2FfE1B6C4746340910a44B96",
+                    "  Network: Base (Chain ID 8453)",
+                    "",
+                    "OPTION 3: Stripe (card)",
+                    "  100 calls — $9.99 | 500 calls — $39.99 | 1,000 calls — $69.99",
+                    "  Visit: rwacu.com/buy",
+                    "",
+                    "After payment, credits are added to your key automatically.",
+                    "Contact: api@zjindustries.com for bulk pricing.",
+                    "",
+                    copperHolidayNote(),
+                    "",
+                    "— mj41, LLC",
+                ].join("\n"),
+            },
+        ],
+    };
+});
+// ════════════════════════════════════════════════════════════
 //   ABOUT
 // ════════════════════════════════════════════════════════════
 // ── about_mj41 ──────────────────────────────────────────────
@@ -510,11 +900,16 @@ server.tool("about_mj41", "Learn about mj41, LLC — who they are, what they bui
                     "",
                     "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_all_copper_prices — All three copper 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.",
                     "",
+                    "METALS ORACLES (ZJ Industries x MJ41)",
+                    "  get_metal_price       — Live price for gold, silver, aluminum, platinum, or palladium",
+                    "  get_all_metal_prices  — All 8 oracles (3 copper + 5 metals) at once",
+                    "  All on-chain on Base mainnet, auto-updated every 15 min during market hours.",
+                    "",
                     "RICHARD TRACY (Blockchain Detective by mj41)",
                     "  investigate_wallet — Phishing/scam/drainer investigation with full case report",
                     "  get_eth_price      — Current ETH price in USD",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mj41-mcp",
-  "version": "1.3.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.",
+  "version": "1.5.0",
+  "description": "MJ41 MCP Server — Agent gateway for mj41, LLC. Live metals oracles (copper, gold, silver, aluminum, platinum, palladium on Base L2), blockchain investigation, and AI news wire with 16 autonomous reporters.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {