Instantly MCP Server

Instructions

Implementation Reference

• src/handlers/tool-executor.ts:952-973 (handler)

  Main handler logic for 'get_email' tool: validates email_id parameter, calls Instantly API endpoint `/emails/{email_id}` to fetch email details, formats and returns the response.

  case 'get_email': {
    console.error('[Instantly MCP] 📧 Executing get_email...');
  
    if (!args.email_id) {
      throw new McpError(ErrorCode.InvalidParams, 'Email ID is required for get_email');
    }
  
    const emailResult = await makeInstantlyRequest(`/emails/${args.email_id}`, {}, apiKey);
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify({
            success: true,
            email: emailResult,
            message: 'Email retrieved successfully'
          }, null, 2)
        }
      ]
    };
  }

• src/validation.ts:563-565 (schema)

  Zod schema for validating 'get_email' input parameters (requires email_id string).

  export const GetEmailSchema = z.object({
    email_id: z.string().min(1, { message: 'Email ID cannot be empty' })
  });

• src/tools/email-tools.ts:39-51 (registration)

  Tool registration/definition including name, description, annotations, and input schema for the MCP tools list.

  {
    name: 'get_email',
    title: 'Get Email',
    description: 'Get email details by ID',
    annotations: { readOnlyHint: true },
    inputSchema: {
      type: 'object',
      properties: {
        email_id: { type: 'string', description: 'Email UUID' }
      },
      required: ['email_id']
    }
  },

• src/tools/index.ts:99-100 (registration)

  Central tools registry that includes emailTools (containing get_email) via aggregation from category files.

  export const TOOLS_DEFINITION = buildToolsDefinition();

• src/validation.ts:780-782 (schema)

  Validation function for get_email parameters using the GetEmailSchema.

  export function validateGetEmailData(args: unknown): z.infer<typeof GetEmailSchema> {
    return validateWithSchema(GetEmailSchema, args, 'get_email');
  }