promptz.dev MCP Server

Instructions

Implementation Reference

• src/tools.ts:30-58 (handler)

  The primary handler function for the 'get_prompt' tool. It validates the input name, fetches the prompt using getPromptByName, constructs a response object, and serializes it to JSON for the tool result.

  export async function getPromptToolHandler(request: CallToolRequest): Promise<CallToolResult> {
    const name = request.params.arguments?.name as string | undefined;
  
    if (!name) {
      throw new Error("Prompt name is required");
    }
    const prompt = await getPromptByName(name);
    if (!prompt) {
      throw new Error(`Prompt not found: ${name}`);
    }
  
    const promptData = {
      name: prompt.name,
      description: prompt.description,
      tags: prompt.tags || [],
      author: prompt.author?.displayName,
      instruction: prompt.instruction,
      howto: prompt.howto || "",
    };
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(promptData, null, 2),
        },
      ],
    };
  }

• src/index.ts:51-63 (registration)

  Tool registration in the ListToolsRequestHandler response. Defines the name, description, and input schema for 'get_prompt'.

  {
    name: "get_prompt",
    description: "Get a specific prompt by ID or name",
    inputSchema: {
      type: "object",
      properties: {
        name: {
          type: "string",
          description: "Name of the prompt to retrieve",
        },
      },
    },
  },

• src/index.ts:111-113 (registration)

  Dispatch logic in the CallToolRequestHandler switch statement that routes 'get_prompt' calls to the getPromptToolHandler.

  case "get_prompt": {
    return await getPromptToolHandler(request);
  }

• src/definitions.ts:2-16 (schema)

  TypeScript interface defining the structure of a Prompt object, used in the tool's response formatting and GraphQL responses.

  export interface Prompt {
    id?: string;
    name: string;
    description: string;
    tags?: string[];
    instruction: string;
    sourceURL?: string;
    howto?: string;
    public?: boolean;
    author?: {
      displayName: string;
    };
    createdAt?: string;
    updatedAt?: string;
  }

• src/graphql-client.ts:60-88 (helper)

  Helper function that performs the GraphQL query to fetch a prompt by its name, handling errors and returning the Prompt object or null.

  export async function getPromptByName(name: string): Promise<Prompt | null> {
    try {
      logger.info(`[API] Getting prompt by name: ${name}`);
  
      // Search for prompts with the exact name
      const { data, error } = await client.query(
        gql`
          ${GET_PROMPT_BY_NAME}
        `,
        { name },
      );
  
      if (error) {
        throw error;
      }
  
      const prompts = data.listByName.items;
      if (prompts.length === 0) {
        return null;
      }
  
      let prompt = prompts[0];
  
      return prompt;
    } catch (error) {
      logger.error(`[Error] Failed to get prompt by name: ${error instanceof Error ? error.message : String(error)}`);
      throw new Error(`Failed to get prompt by name: ${error instanceof Error ? error.message : String(error)}`);
    }
  }