example.mjs

/**
 * ForgeMCP SDK — Usage Examples
 * Run: node example.mjs
 */

import ForgeMCP from "./index.js";

const forge = new ForgeMCP({ apiKey: process.env.FORGEMCP_KEY || "bk_forge_test" });

async function examples() {
  // ─── Web Search ───────────────────────────────────────────
  console.log("\n🔍 Web Search:");
  const search = await forge.web_search({ query: "MCP model context protocol 2026" });
  console.log(JSON.stringify(search, null, 2));

  // ─── URL Fetch ─────────────────────────────────────────────
  console.log("\n🌐 URL Fetch:");
  const page = await forge.url_fetch({
    url: "https://modelcontextprotocol.io",
    maxChars: 2000,
  });
  console.log(`Title: ${page.title}`);
  console.log(`Content: ${page.excerpt}`);

  // ─── Code Execute ───────────────────────────────────────────
  console.log("\n⚡ Code Execute:");
  const result = await forge.code_execute({
    code: `
      const data = [
        { name: 'Alice', score: 92 },
        { name: 'Bob', score: 78 },
        { name: 'Carol', score: 95 }
      ];
      const avg = data.reduce((sum, d) => sum + d.score, 0) / data.length;
      const top = data.filter(d => d.score > avg).map(d => d.name);
      JSON.stringify({ average: avg, aboveAverage: top }, null, 2);
    `,
  });
  console.log(result.result);

  // ─── Data Store ─────────────────────────────────────────────
  console.log("\n💾 Data Store:");
  await forge.data_store({
    operation: "set",
    key: "research_session",
    value: { topic: "AI agents", date: new Date().toISOString() },
  });

  const stored = await forge.data_store({
    operation: "get",
    key: "research_session",
  });
  console.log("Retrieved:", JSON.stringify(stored.value));

  // ─── Analytics Track ─────────────────────────────────────────
  console.log("\n📊 Analytics:");
  await forge.analytics_track({
    operation: "track",
    event: "example_run",
    properties: { source: "docs_example", language: "nodejs" },
  });

  const stats = await forge.analytics_track({
    operation: "stats",
    days: 7,
  });
  console.log("Event counts:", JSON.stringify(stats.stats));

  // ─── Weather ─────────────────────────────────────────────────
  console.log("\n🌤️ Weather:");
  const weather = await forge.weather({ location: "Cottage Grove, MN" });
  console.log(`${weather.location}: ${weather.temp}°F, ${weather.conditions}`);

  // ─── Account ────────────────────────────────────────────────
  console.log("\n👤 Usage Stats:");
  const usage = await forge.usage();
  console.log(
    `Tier: ${usage.tier} | Used: ${usage.currentMonth.requestsUsed}/${usage.currentMonth.requestsLimit} requests`
  );
}

examples().catch(console.error);