pocketbase-mcp-server

Implementation Reference

• src/services/email.ts:176-212 (handler)

  Core handler function that sends custom email using nodemailer transporter and logs to PocketBase email_logs collection.

  async sendCustomEmail(data: {
    to: string;
    from?: string;
    subject: string;
    html: string;
    text?: string;
  }): Promise<EmailLog> {
    try {
      // Send email
      const info = await this.transporter.sendMail({
        from: data.from || process.env.SMTP_USER || process.env.DEFAULT_FROM_EMAIL,
        to: data.to,
        subject: data.subject,
        html: data.html,
        text: data.text,
      });      // Log email
      const emailLog = await this.pb.collection('email_logs').create({
        to: data.to,
        from: data.from || process.env.SMTP_USER || process.env.DEFAULT_FROM_EMAIL,
        subject: data.subject,
        status: 'sent',
      });
  
      return emailLog as unknown as EmailLog;
    } catch (error: any) {
      // Log failed email
      const emailLog = await this.pb.collection('email_logs').create({
        to: data.to,
        from: data.from || process.env.SMTP_USER || process.env.DEFAULT_FROM_EMAIL,
        subject: data.subject,
        status: 'failed',
        error: error.message,
      });
  
      throw new Error(`Failed to send custom email: ${error.message}`);
    }
  }

• src/agent-simple.ts:790-837 (registration)

  MCP server tool registration for 'send_custom_email' including input schema validation with zod and wrapper handler that invokes EmailService.sendCustomEmail

  this.server.tool(
    'send_custom_email',
    {
      description: 'Send a custom email with specified content',
      inputSchema: {
        to: z.string().email().describe('Recipient email address'),
        from: z.string().email().optional().describe('Sender email address'),
        subject: z.string().describe('Email subject'),
        html: z.string().describe('HTML email body'),
        text: z.string().optional().describe('Plain text email body')
      }
    },
    async ({ to, from, subject, html, text }) => {
      // Lazy load Email service
      await this.ensureEmailService();
      
      if (!this.emailService) {
        throw new Error('Email service not available. Please configure EMAIL_SERVICE or SMTP settings.');
      }
  
      try {
        const result = await this.emailService.sendCustomEmail({
          to,
          from,
          subject,
          html,
          text
        });
        return {
          content: [{
            type: 'text',
            text: JSON.stringify({
              success: true,
              emailLog: {
                id: result.id,
                to: result.to,
                subject: result.subject,
                status: result.status,
                sentAt: result.created
              }
            }, null, 2)
          }]
        };
      } catch (error: any) {
        throw new Error(`Failed to send email: ${error.message}`);
      }
    }
  );

• dist/services/email.d.ts:31-37 (schema)

  TypeScript type definition/schema for the sendCustomEmail method parameters.

  sendCustomEmail(data: {
      to: string;
      from?: string;
      subject: string;
      html: string;
      text?: string;
  }): Promise<EmailLog>;

• src/agent-best-practices.ts:967-1007 (registration)

  Another MCP tool registration for 'send_custom_email' in the best-practices agent with similar schema and handler.

    {
      to: EmailAddressSchema,
      from: EmailAddressSchema.optional(),
      subject: z.string().describe('Email subject'),
      htmlBody: z.string().optional().describe('HTML email body'),
      textBody: z.string().optional().describe('Plain text email body')
    },
    async ({ to, from, subject, htmlBody, textBody }) => {
      try {
        if (!this.emailService) {
          return this.createErrorResponse('Email service not available');
        }
  
        const result = await this.emailService.sendCustomEmail({
          to,
          from,
          subject,
          html: htmlBody || '',
          text: textBody
        });
        
        return {
          content: [{
            type: 'text',
            text: JSON.stringify({
              success: true,
              emailLog: {
                id: result.id,
                to: result.to,
                subject: result.subject,
                status: result.status,
                sentAt: result.created
              }
            }, null, 2)
          }]
        };
      } catch (error) {
        return this.createErrorResponse(error);
      }
    }
  );

• src/worker.ts:328-342 (schema)

  JSON schema for send_custom_email tool in worker tools list for discovery.

  {
    name: 'send_custom_email',
    description: 'Send a custom email with specified content',
    inputSchema: {
      type: 'object',
      properties: {
        to: { type: 'string', format: 'email', description: 'Recipient email address' },
        from: { type: 'string', format: 'email', description: 'Sender email address' },
        subject: { type: 'string', description: 'Email subject' },
        html: { type: 'string', description: 'HTML email body' },
        text: { type: 'string', description: 'Plain text email body' }
      },
      required: ['to', 'subject', 'html']
    }
  }