Scryfall MCP Server

Instructions

Implementation Reference

• index.ts:265-269 (handler)

  The main handler function for the random_card tool, which fetches a random card from the Scryfall API endpoint and processes the response using handleScryfallResponse.

  async function handleRandomCard() {
    const url = "https://api.scryfall.com/cards/random";
    const response = await fetch(url);
    return handleScryfallResponse(response);
  }

• index.ts:124-133 (schema)

  Tool schema definition for random_card, including name, description, and inputSchema with no required parameters.

  const RANDOM_CARD_TOOL: Tool = {
    name: "random_card",
    description:
      "Retrieve a random Magic card from Scryfall. Returns JSON data for that random card.",
    inputSchema: {
      type: "object",
      properties: {},
      required: []
    }
  };

• index.ts:186-194 (registration)

  Registration of the random_card tool (as RANDOM_CARD_TOOL) in the SCRYFALL_TOOLS array, which is returned by the ListTools handler.

  const SCRYFALL_TOOLS = [
    SEARCH_CARDS_TOOL,
    GET_CARD_BY_ID_TOOL,
    GET_CARD_BY_NAME_TOOL,
    RANDOM_CARD_TOOL,
    GET_RULINGS_TOOL,
    GET_PRICES_BY_ID_TOOL,
    GET_PRICES_BY_NAME_TOOL
  ] as const;

• index.ts:386-388 (registration)

  Routing/registration in the CallToolRequestSchema switch statement that invokes the random_card handler.

  case "random_card": {
    return await handleRandomCard();
  }