Resurgo-MCP

Instructions

Implementation Reference

• src/nodes.ts:112-131 (handler)

  The handler function for the 'quick_capture' MCP tool. It calls the API client to perform the capture and formats the response as MCP content, handling errors appropriately.

    async ({ state }) => {
      const result = await apiClient.quickCapture(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:95-110 (schema)

  Zod schema defining the input parameters for the quick_capture tool: title (required), note, url, tags, resurfaceIn (optional).

  state: z.object({
    title: z.string().describe('The title of the node'),
    note: z.string().optional().describe('Optional notes or body content'),
    url: z.string().url().optional().describe('Optional URL to attach'),
    tags: z
      .array(z.string())
      .optional()
      .default([])
      .describe('Tags for categorization'),
    resurfaceIn: z
      .string()
      .optional()
      .describe(
        'When to resurface: "tomorrow", "1 week", "2025-01-15", etc.',
      ),
  }),

• src/nodes.ts:91-94 (registration)

  Registration of the 'quick_capture' tool on the MCP server within registerNodesTools.

  server.tool(
    'quick_capture',
    'Save a new node with optional scheduling',
    {

• src/api-client.ts:79-90 (helper)

  Helper method in the API client that sends the quick capture request to the backend /mcp/quick-capture endpoint.

  async quickCapture(params: {
    title: string;
    note?: string;
    url?: string;
    tags?: string[];
    resurfaceIn?: string;
  }): Promise<ApiResponse<any>> {
    return this.request('/mcp/quick-capture', {
      method: 'POST',
      body: JSON.stringify(params),
    });
  }