mj41-mcp 1.3.0 → 1.4.0

package/dist/index.js

@@ -73,8 +73,46 @@ 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",
@@ -95,6 +133,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 +166,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 +185,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 +236,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];
@@ -226,6 +273,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 +314,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 +350,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 +410,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 +464,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 +508,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 +557,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 ──────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mj41-mcp",
-  "version": "1.3.0",
+  "version": "1.4.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",