# GitHub Hot MCP Server Guide

Endpoint: POST https://git.zoyku.com/api/mcp (JSON-RPC 2.0)

## Available Tools
- **list_boards**: List all 34 GitHub Hot boards (10 base boards + 24 language-faceted boards).
  Schema: `{"type":"object","properties":{}}`
- **get_board**: Get ranked repositories from a published GitHub Hot board (e.g., overall, weekly, dark, rising, milestone).
  Schema: `{"type":"object","properties":{"slug":{"type":"string","enum":["overall","weekly","monthly","annual","rising","dark","overlooked","controversial","forks","milestone"],"description":"Board slug"},"language":{"type":"string","enum":["javascript","typescript","python","go","rust","java","c","c++"],"description":"Optional programming language facet (supported for overall, weekly, monthly)"},"limit":{"type":"number","description":"Max items to return (1..100, default 30)"}},"required":["slug"]}`
- **get_repo**: Get full archive telemetry, active board rankings, and star history for a GitHub repository (owner/repo).
  Schema: `{"type":"object","properties":{"fullName":{"type":"string","description":"Repository full name in owner/repo format"}},"required":["fullName"]}`
- **get_history**: Get historical daily snapshot for a board on a specific YYYY-MM-DD date, or list available dates if date is omitted.
  Schema: `{"type":"object","properties":{"slug":{"type":"string","enum":["overall","weekly","monthly","annual","rising","dark","overlooked","controversial","forks","milestone"]},"date":{"type":"string","description":"Optional YYYY-MM-DD date"}},"required":["slug"]}`
- **discover_repos**: Filter and sort indexed open-source repositories by language, topic tag, and sort order (gain, stars, new).
  Schema: `{"type":"object","properties":{"language":{"type":"string"},"topic":{"type":"string"},"sort":{"type":"string","enum":["gain","stars","new"]},"limit":{"type":"number"}}}`
- **search_repos**: Search tracked repositories by keyword in owner/repo name or description.
  Schema: `{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"number"}},"required":["query"]}`