github_codes_of_conduct_get_conduct_code
Retrieve a GitHub code of conduct by its key. This tool returns the full text, name, and URL of the code.
Instructions
Get a code of conduct
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | key |
Implementation Reference
- src/tools/codes-of-conduct.ts:14-22 (handler)The handler for 'github_codes_of_conduct_get_conduct_code' that makes a GET request to /codes_of_conduct/{key} on the GitHub API. It accepts a 'key' path parameter and delegates to githubRequest.
{ name: "github_codes_of_conduct_get_conduct_code", description: "Get a code of conduct", inputSchema: z.object({ key: z.string().describe("key") }), handler: async (args: Record<string, any>) => { return githubRequest("GET", `/codes_of_conduct/${args.key}`, undefined, undefined); }, - src/tools/codes-of-conduct.ts:17-19 (schema)The input schema for the tool, defining a required string parameter 'key' via Zod.
inputSchema: z.object({ key: z.string().describe("key") }), - src/index.ts:110-129 (registration)Registration of all tools (including this one) via server.tool() in the MCP server. The tool's name, description, schema shape, and handler are registered.
for (const tool of allTools) { server.tool( tool.name, tool.description, tool.inputSchema.shape as any, async (args: any) => { try { const result = await tool.handler(args as any); return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }], }; } catch (err) { const message = err instanceof Error ? err.message : String(err); return { content: [{ type: "text" as const, text: `Error: ${message}` }], isError: true, }; } } ); - src/client.ts:9-59 (helper)The githubRequest helper function that executes the actual HTTP call to the GitHub API with auth headers.
export async function githubRequest<T>( method: string, path: string, body?: Record<string, unknown>, params?: Record<string, string | number | boolean | string[] | undefined> ): Promise<T> { const url = new URL(`${BASE_URL}${path}`); if (params) { for (const [key, value] of Object.entries(params)) { if (value === undefined || value === null || value === "") continue; if (Array.isArray(value)) { url.searchParams.set(key, value.join(",")); } else { url.searchParams.set(key, String(value)); } } } const headers: Record<string, string> = { Authorization: `Bearer ${getToken()}`, Accept: "application/vnd.github+json", "X-GitHub-Api-Version": "2022-11-28", "User-Agent": "github-mcp/1.0.0", }; if (body) { headers["Content-Type"] = "application/json"; } const res = await fetch(url.toString(), { method, headers, body: body ? JSON.stringify(body) : undefined, }); if (!res.ok) { const text = await res.text().catch(() => ""); let detail = text; try { const json = JSON.parse(text); detail = json.message || text; if (json.errors) detail += ` -- ${JSON.stringify(json.errors)}`; } catch {} throw new Error(`GitHub API error ${res.status}: ${detail}`); } if (res.status === 204) return {} as T; return res.json() as Promise<T>; }