get_issue
Retrieve complete newsletter content from the Entra.news archive by specifying an issue number or publication date. Access full text with preserved section headings for Microsoft Entra announcements and updates.
Instructions
Retrieve the full content of a specific Entra.news issue by issue number or publication date. Returns the complete text of the newsletter with section headings preserved.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issue_number | No | Issue number (e.g. 42) | |
| date | No | Date in YYYY-MM-DD or YYYY-MM format to find the nearest issue (e.g. "2024-03" or "2024-03-15") |
Implementation Reference
- src/tools/get-issue.ts:47-77 (handler)The main handler function for the `get_issue` tool, which retrieves issue data by number or date and formats the response.
export function handleGetIssue(args: GetIssueArgs): string { if (args.issue_number == null && !args.date) { return 'Please provide either an issue_number or a date to look up.'; } let issue: Issue | null = null; if (args.issue_number != null) { issue = getIssueByNumber(args.issue_number); if (!issue) { return `Issue #${args.issue_number} not found in the archive.`; } } else if (args.date) { issue = getIssueByDate(args.date); if (!issue) { return `No issue found for date "${args.date}". Try a broader date range (e.g. just the year-month like "2024-03").`; } } if (!issue) return 'Issue not found.'; const chunks = getChunksForIssue(issue.id); const fullText = chunks .map((c) => { const heading = c.section_heading ? `### ${c.section_heading}\n\n` : ''; return `${heading}${c.text.trim()}`; }) .join('\n\n'); return formatIssue(issue, fullText || '*No content available for this issue.*'); } - src/tools/get-issue.ts:9-20 (schema)Input validation schema for the `get_issue` tool arguments.
export const getIssueSchema = z.object({ issue_number: z .number() .int() .positive() .optional() .describe('Issue number (e.g. 42)'), date: z .string() .optional() .describe('Date in YYYY-MM-DD or YYYY-MM format to find the nearest issue'), }); - src/server.ts:45-64 (registration)Tool registration and definition for `get_issue` within the main server configuration.
{ name: 'get_issue', description: 'Retrieve the full content of a specific Entra.news issue by issue number or publication date. ' + 'Returns the complete text of the newsletter with section headings preserved.', inputSchema: { type: 'object', properties: { issue_number: { type: 'number', description: 'Issue number (e.g. 42)', }, date: { type: 'string', description: 'Date in YYYY-MM-DD or YYYY-MM format to find the nearest issue (e.g. "2024-03" or "2024-03-15")', }, }, }, },