drag-race-mcp: Skill for Cursor

MCP tools — drag-race-mcp

Follow TypeScript conventions from the typescript-style skill (arrow consts, .ts imports).

Layout

src/tools/
  utility.ts                 # toolResult + readOnlyAnnotations
  scope_fields.ts            # shared franchise/region/origin filters
  general|seasons|queens|episodes|lore/
    index.ts                 # register{Domain}Tools(server)
    snake_case_tool.ts       # one tool per file
src/server.ts                # calls each register{Domain}Tools

Registration chain: tool registerX → domain index.ts → src/server.ts.

Per-tool file

Canonical smoke-test (annotated): src/tools/general/welcome_user.ts.
Real data tool: src/tools/queens/get_queen.ts.

Structure every tool file like this:

import type { McpServer } from "@modelcontextprotocol/server";
import { z } from "zod";
import { toolResult, readOnlyAnnotations } from "../utility.ts";
// + service/accessor + kb schemas as needed

const inputSchema = z.object({
  // fields with .describe("...") for the LLM
});

const outputSchema = z.object({
  // or z.discriminatedUnion("ok", [...])
});

type Output = z.infer<typeof outputSchema>;

/** Register the `snake_name` tool (...). */
export const registerThing = (server: McpServer) => {
  server.registerTool(
    "snake_name",
    {
      description:
        "Verb + resource + scope. When to use / when not to use; name sibling tools. Do not recap the output schema.",
      inputSchema,
      outputSchema,
      annotations: readOnlyAnnotations,
    },
    async (args) => {
      const output: Output = { /* ... */ };
      return toolResult(output);
    },
  );
};

Always return toolResult(output) from src/tools/utility.ts (JSON text in content + same object in structuredContent).

Always pass annotations: readOnlyAnnotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false). This KB is local JSON, not the live web.

TDQS descriptions