status
Read-only
Check current pull request tracking status to monitor open PRs, shelved PRs, and dismissed issues for open source project management.
Instructions
Show current PR tracking status including open PRs, shelved PRs, and dismissed issues.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| offline | No | If true, show only locally cached state without fetching from GitHub |
Implementation Reference
- The handler function for the "status" tool, which reads contribution statistics from the local state.
export async function runStatus(options: StatusOptions): Promise<StatusOutput> { const stateManager = getStateManager(); const stats = stateManager.getStats(); const state = stateManager.getState(); // Status always reads from local state (no API calls), so offline mode // simply adds metadata about cache freshness. const lastUpdated = state.lastDigestAt || state.lastRunAt; // Extract only the stats we want to output (exclude totalTracked) const { totalTracked: _totalTracked, ...outputStats } = stats as typeof stats & { totalTracked?: number }; const output: StatusOutput = { stats: outputStats, lastRunAt: state.lastRunAt, }; if (options.offline) { output.offline = true; output.lastUpdated = lastUpdated; } return output; } - packages/mcp-server/src/tools.ts:76-90 (registration)Registration of the "status" tool in the MCP server.
// 2. status — Show tracking status server.registerTool( 'status', { description: 'Show current PR tracking status including open PRs, shelved PRs, and dismissed issues.', inputSchema: { offline: z .boolean() .optional() .describe('If true, show only locally cached state without fetching from GitHub'), }, annotations: { readOnlyHint: true }, }, wrapTool(runStatus), );