Resurgo-MCP

Instructions

Implementation Reference

• src/nodes.ts:148-165 (handler)

  The MCP tool handler function for 'snooze_node'. It calls apiClient.snoozeNode(state), handles errors by returning error content, and formats successful data as JSON text response.

    const result = await apiClient.snoozeNode(state);
  
    if (result.error) {
      return {
        content: [{ type: 'text', text: result.error }],
        isError: true,
      };
    }
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result.data, null, 2),
        },
      ],
    };
  },

• src/nodes.ts:138-147 (schema)

  Zod input schema definition for the 'snooze_node' tool, validating nodeId as UUID string and until as string with description.

    state: z.object({
      nodeId: z.string().uuid().describe('The ID of the node to snooze'),
      until: z
        .string()
        .describe(
          'When to resurface: "tomorrow", "next week", "2025-01-15", etc.',
        ),
    }),
  },
  async ({ state }) => {

• src/nodes.ts:135-166 (registration)

  MCP server.tool registration for 'snooze_node' tool, including name, description, schema, and handler function.

    'snooze_node',
    'Defer resurfacing to a later date',
    {
      state: z.object({
        nodeId: z.string().uuid().describe('The ID of the node to snooze'),
        until: z
          .string()
          .describe(
            'When to resurface: "tomorrow", "next week", "2025-01-15", etc.',
          ),
      }),
    },
    async ({ state }) => {
      const result = await apiClient.snoozeNode(state);
  
      if (result.error) {
        return {
          content: [{ type: 'text', text: result.error }],
          isError: true,
        };
      }
  
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(result.data, null, 2),
          },
        ],
      };
    },
  );

• src/api-client.ts:92-100 (helper)

  API client helper method 'snoozeNode' that performs POST request to backend '/mcp/snooze-node' endpoint with params.

  async snoozeNode(params: {
    nodeId: string;
    until: string;
  }): Promise<ApiResponse<any>> {
    return this.request('/mcp/snooze-node', {
      method: 'POST',
      body: JSON.stringify(params),
    });
  }