YubHub MCP Server

Instructions

Implementation Reference

• src/index.ts:773-803 (handler)

  Main handler function for 'get_feed' tool. Retrieves feed details from API client, formats statistics (enriched/failed counts), and returns formatted markdown response with feed status, statistics, and timestamps.

    private async getFeed({ feedId }: { feedId: string }) {
      const feedDetails = await this.apiClient.getFeedDetails(feedId);
      const enriched = feedDetails.stats.enriched ?? 0;
      const failed = feedDetails.stats.failed ?? 0;
  
      const markdown = `# ${feedDetails.feed.name}
  
  **Status**: ${feedDetails.feed.is_active ? '✅ Active' : '⚪ Inactive'}
  **Feed ID**: \`${feedDetails.feed.id}\`
  **Careers URL**: ${feedDetails.feed.careers_url}
  ${feedDetails.feed.example_job_url ? `**Example Job URL**: ${feedDetails.feed.example_job_url}` : ''}
  
  ## Statistics
  - **Total Jobs**: ${feedDetails.stats.total}
  - **Enriched**: ${enriched} ✅
  - **Failed**: ${failed} ❌
  
  **Last Run**: ${feedDetails.feed.last_run_at ? new Date(feedDetails.feed.last_run_at).toLocaleString() : 'Never'}
  **Created**: ${new Date(feedDetails.feed.created_at).toLocaleString()}
  **Updated**: ${new Date(feedDetails.feed.updated_at).toLocaleString()}
  `;
  
      return {
        content: [
          {
            type: 'text',
            text: markdown,
          },
        ],
      };
    }

• src/index.ts:372-384 (schema)

  Tool registration with name 'get_feed', description, and JSON schema defining feedId as a required string parameter for input validation.

  name: 'get_feed',
  description: 'Get detailed information about a specific feed including statistics',
  inputSchema: {
    type: 'object',
    properties: {
      feedId: {
        type: 'string',
        description: 'Feed ID to retrieve'
      }
    },
    required: ['feedId'],
    additionalProperties: false
  }

• src/index.ts:665-666 (registration)

  Switch case routing 'get_feed' tool calls to the getFeed handler method.

  case 'get_feed':
    return await this.getFeed(args as any);

• src/api-client.ts:46-48 (helper)

  API client helper method that makes HTTP GET request to /api/feeds/{feedId} endpoint to retrieve feed details.

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