promptz.dev MCP Server

Instructions

Implementation Reference

• src/tools.ts:85-112 (handler)

  The primary handler function for the "get_rule" tool. It validates the input name, fetches the rule via getRuleByName, formats the response data, and returns it as a JSON text content block.

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

• src/index.ts:117-119 (registration)

  Registration in the CallToolRequest switch statement, dispatching calls to the get_rule tool to its handler function.

  case "get_rule": {
    return await getRuleToolHandler(request);
  }

• src/index.ts:84-96 (registration)

  Tool registration in the ListToolsRequest handler, defining the name, description, and input schema for the "get_rule" tool.

  {
    name: "get_rule",
    description: "Get a specific project rule by name",
    inputSchema: {
      type: "object",
      properties: {
        name: {
          type: "string",
          description: "Name of the rule to retrieve",
        },
      },
    },
  },

• src/graphql-client.ts:112-138 (helper)

  Supporting helper function that executes the GraphQL query to fetch a project rule by its name, used by the tool handler.

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