Scryfall MCP Server

Instructions

Implementation Reference

• index.ts:312-343 (handler)

  The handler function that fetches the Scryfall card by exact name and returns its price information in JSON format.

  async function handleGetPricesByName(name: string) {
    const url = `https://api.scryfall.com/cards/named?exact=${encodeURIComponent(
      name
    )}`;
    const response = await fetch(url);
    if (!response.ok) {
      return handleScryfallResponse(response);
    }
    const data = (await response.json()) as ScryfallCard;
  
    if (!data.prices) {
      return {
        content: [
          {
            type: "text",
            text: "No price information found for this card."
          }
        ],
        isError: false
      };
    }
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(data.prices, null, 2)
        }
      ],
      isError: false
    };
  }

• index.ts:169-183 (schema)

  Defines the tool schema, including name, description, and input schema requiring a 'name' string parameter.

  const GET_PRICES_BY_NAME_TOOL: Tool = {
    name: "get_prices_by_name",
    description:
      "Retrieve price information for a card by its exact name. Returns JSON with usd, usd_foil, eur, tix, etc.",
    inputSchema: {
      type: "object",
      properties: {
        name: {
          type: "string",
          description: "Exact card name"
        }
      },
      required: ["name"]
    }
  };

• index.ts:186-194 (registration)

  Registers the get_prices_by_name tool by including it 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:397-400 (registration)

  Registers the handler for get_prices_by_name tool calls within the switch statement of the CallToolRequestSchema handler.

  case "get_prices_by_name": {
    const { name } = args as { name: string };
    return await handleGetPricesByName(name);
  }