YubHub MCP Server

Instructions

Implementation Reference

• src/index.ts:946-979 (handler)

  The main handler function that executes the get_feed_schedule tool. It fetches the schedule via the API client, formats dates, and returns a formatted text response with schedule details including auto-run status, interval, next run, and last run times.

    private async getFeedSchedule({ feedId }: { feedId: string }) {
      const schedule = await this.apiClient.getFeedSchedule(feedId);
  
      const nextRun = schedule.nextRunAt
        ? new Date(schedule.nextRunAt).toLocaleString()
        : 'Not scheduled';
  
      const lastRun = schedule.lastRunAt
        ? new Date(schedule.lastRunAt).toLocaleString()
        : 'Never';
  
      const statusEmoji = schedule.autoRunEnabled ? '✅' : '⚪';
  
      return {
        content: [
          {
            type: 'text',
            text: `# Schedule for ${schedule.name}
  
  **Status**: ${statusEmoji} ${schedule.autoRunEnabled ? 'Auto-run Enabled' : 'Auto-run Disabled'}
  **Feed ID**: \`${schedule.feedId}\`
  **Interval**: Every ${schedule.intervalDays} day${schedule.intervalDays !== 1 ? 's' : ''}
  
  ## Schedule Details
  - **Next Run**: ${nextRun}
  - **Last Run**: ${lastRun}
  
  ${schedule.autoRunEnabled
    ? `This feed will automatically trigger every ${schedule.intervalDays} days. The scheduler runs hourly and will pick up this feed when it's due.`
    : 'This feed requires manual triggering. Enable auto-run to schedule automatic runs.'}`,
          },
        ],
      };
    }

• src/index.ts:686-688 (registration)

  The tool routing/dispatch logic that maps the 'get_feed_schedule' tool name to its handler function in the switch statement.

  case 'get_feed_schedule':
    return await this.getFeedSchedule(args as any);

• src/index.ts:486-499 (schema)

  Tool registration defining the name, description, and input schema. Requires a 'feedId' string parameter to identify which feed's schedule to retrieve.

  {
    name: 'get_feed_schedule',
    description: 'Get the automatic run schedule configuration for a feed. Shows if auto-run is enabled, the run interval, and when the next automatic run is scheduled.',
    inputSchema: {
      type: 'object',
      properties: {
        feedId: {
          type: 'string',
          description: 'Feed ID to check schedule for'
        }
      },
      required: ['feedId'],
      additionalProperties: false
    }

• src/types.ts:59-66 (schema)

  TypeScript interface defining the structure of a FeedSchedule response, including feedId, name, auto-run status, interval in days, and timestamps for next/last runs.

  export interface FeedSchedule {
    feedId: string;
    name: string;
    autoRunEnabled: boolean;
    intervalDays: number;
    nextRunAt: string | null;
    lastRunAt: string | null;
  }

• src/api-client.ts:84-86 (helper)

  API client helper method that makes the HTTP GET request to /api/feeds/{feedId}/schedule endpoint to fetch the feed schedule data from the backend.

  async getFeedSchedule(feedId: string): Promise<FeedSchedule> {
    return this.request(`/api/feeds/${feedId}/schedule`);
  }