AFFiNE MCP Server

Instructions

Implementation Reference

• src/tools/userCRUD.ts:100-116 (handler)

  The asynchronous handler function that implements the tool logic: sends a verification email using a GraphQL mutation to the server, with optional callbackUrl, handles success/error responses.

  const sendVerifyEmailHandler = async ({ callbackUrl }: { callbackUrl?: string }) => {
    try {
      const mutation = `
        mutation SendVerifyEmail($callbackUrl: String!) {
          sendVerifyEmail(callbackUrl: $callbackUrl)
        }
      `;
      
      const data = await gql.request<{ sendVerifyEmail: boolean }>(mutation, {
        callbackUrl: callbackUrl || `${process.env.AFFINE_BASE_URL}/verify`
      });
      
      return text({ success: data.sendVerifyEmail, message: "Verification email sent" });
    } catch (error: any) {
      return text({ error: error.message });
    }
  };

• src/tools/userCRUD.ts:119-125 (schema)

  The input schema definition using Zod for the tool, specifying optional callbackUrl parameter.

  {
    title: "Send Verification Email",
    description: "Send email verification link.",
    inputSchema: {
      callbackUrl: z.string().optional().describe("Callback URL after verification")
    }
  },

• src/tools/userCRUD.ts:117-127 (registration)

  Registers the 'affine_send_verify_email' tool with the MCP server, linking the schema and handler function.

  server.registerTool(
    "affine_send_verify_email",
    {
      title: "Send Verification Email",
      description: "Send email verification link.",
      inputSchema: {
        callbackUrl: z.string().optional().describe("Callback URL after verification")
      }
    },
    sendVerifyEmailHandler as any
  );