YubHub MCP Server

Instructions

Implementation Reference

• src/index.ts:1171-1188 (handler)

  Main handler function that fetches experience level data from API, calculates percentages, and formats results as a markdown table

    private async getExperienceLevels() {
      const { data } = await this.apiClient.getExperienceLevels();
      const total = data.reduce((s, e) => s + e.count, 0);
      const rows = data.map(e => {
        const pct = total > 0 ? ((e.count / total) * 100).toFixed(1) : '0';
        return `| ${e.level} | ${e.count} | ${pct}% |`;
      }).join('\n');
      return {
        content: [{
          type: 'text',
          text: `**Experience Level Distribution**
  
  | Level | Count | % |
  |-------|-------|---|
  ${rows}`,
        }],
      };
    }

• src/types.ts:107-110 (schema)

  Type definition for experience level statistics with level name and count

  export interface ExperienceStat {
    level: string;
    count: number;
  }

• src/index.ts:642-650 (registration)

  Tool registration defining the tool name, description, and empty input schema

  {
    name: 'get_experience_levels',
    description: 'Get experience level distribution (entry, mid, senior, etc.).',
    inputSchema: {
      type: 'object',
      properties: {},
      additionalProperties: false
    }
  }

• src/api-client.ts:128-130 (helper)

  API client helper method that makes HTTP request to /stats/experience-levels endpoint

  async getExperienceLevels(): Promise<{ data: ExperienceStat[] }> {
    return this.request('/stats/experience-levels');
  }