get_watchlist_events

Instructions

Implementation Reference

• src/index.ts:149-161 (schema)

  Tool schema registration for 'get_watchlist_events' defining name, description, and input schema (days and types params).

  {
    name: "get_watchlist_events",
    description:
      "Get recent events for companies on your watchlist: funding, acquisitions, " +
      "executive hires, contracts.",
    inputSchema: {
      type: "object" as const,
      properties: {
        days: { type: "number", description: "Look back days (1-90). Default: 7" },
        types: { type: "string", description: "Comma-separated event types" },
      },
    },
  },

• src/index.ts:290-310 (handler)

  Handler implementation for 'get_watchlist_events' that calls GET /watchlist/events API and formats the response into a text summary with event details.

  case "get_watchlist_events": {
    const data = await apiRequest("GET", "/watchlist/events", {
      days: (args as any).days,
      types: (args as any).types,
    });
    const events = data.events || [];
    if (events.length === 0) {
      return textResult(
        `No events found for your ${data.tracked_companies} tracked companies in the last ${data.period_days} days.`
      );
    }
    const summary = events
      .map((e: any, i: number) => {
        let detail = `${i + 1}. [${e.type.toUpperCase()}] ${e.company_name}: ${e.title}`;
        if (e.amount) detail += ` ($${(e.amount / 1_000_000).toFixed(1)}M)`;
        if (e.date) detail += ` | ${e.date}`;
        return detail;
      })
      .join("\n");
    return textResult(`${data.total} events for ${data.tracked_companies} tracked companies:\n\n${summary}`);
  }

• src/index.ts:71-168 (registration)

  Tool registration via ListToolsRequestSchema handler, where the 'get_watchlist_events' tool is registered alongside other tools.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [
      {
        name: "get_scored_leads",
        description:
          "Get AI-scored sales leads based on your ICP (Ideal Customer Profile). " +
          "Returns companies with recent business events scored by AI for buyer intent, " +
          "buying stage, and recommended outreach strategy.",
        inputSchema: {
          type: "object" as const,
          properties: {
            min_score: { type: "number", description: "Minimum buyer intent score (0-100). Default: 0" },
            max_results: { type: "number", description: "Max leads to return (1-50). Default: 25" },
            buying_stages: {
              type: "array",
              items: { type: "string" },
              description: "Filter by buying stage: 'Active Evaluation', 'Decision', 'Research', 'Awareness'",
            },
            industries: {
              type: "array",
              items: { type: "string" },
              description: "Filter by industry (e.g., ['SaaS', 'HealthTech', 'FinTech'])",
            },
          },
        },
      },
      {
        name: "get_events",
        description:
          "Get real-time business events: funding rounds, acquisitions, executive hires, " +
          "government contracts, and product launches. Filter by type, industry, and location.",
        inputSchema: {
          type: "object" as const,
          properties: {
            types: { type: "string", description: "Comma-separated: funding, acquisition, hiring, contract, product_launch. Default: all" },
            days: { type: "number", description: "Look back days (1-90). Default: 7" },
            limit: { type: "number", description: "Max events (1-200). Default: 50" },
            industries: { type: "string", description: "Comma-separated industries" },
            locations: { type: "string", description: "Comma-separated locations" },
          },
        },
      },
      {
        name: "get_market_pulse",
        description:
          "Get real-time market activity overview: funding totals, acquisition counts, " +
          "executive moves, contracts, and product launches for the past 7 and 30 days.",
        inputSchema: { type: "object" as const, properties: {} },
      },
      {
        name: "get_market_brief",
        description:
          "Get today's AI-generated strategic intelligence brief with narrative analysis " +
          "of the most important market movements, patterns, and opportunities.",
        inputSchema: { type: "object" as const, properties: {} },
      },
      {
        name: "manage_watchlist",
        description:
          "Add, remove, or list companies on your watchlist. Tracked companies generate " +
          "alerts when they have new events.",
        inputSchema: {
          type: "object" as const,
          properties: {
            action: {
              type: "string",
              enum: ["list", "add", "remove"],
              description: "Action: 'list' to view, 'add' to track, 'remove' to untrack",
            },
            domains: {
              type: "array",
              items: { type: "string" },
              description: "Company domains for add/remove (e.g., ['stripe.com', 'github.com'])",
            },
          },
          required: ["action"],
        },
      },
      {
        name: "get_watchlist_events",
        description:
          "Get recent events for companies on your watchlist: funding, acquisitions, " +
          "executive hires, contracts.",
        inputSchema: {
          type: "object" as const,
          properties: {
            days: { type: "number", description: "Look back days (1-90). Default: 7" },
            types: { type: "string", description: "Comma-separated event types" },
          },
        },
      },
      {
        name: "get_usage",
        description: "Check your FundzWatch API usage: calls made, limits, current tier.",
        inputSchema: { type: "object" as const, properties: {} },
      },
    ],
  }));